A modern, maintained replacement for ls
 
 
 
 
Go to file
Christina Sørensen 1a36ca2de5 chore: release eza v0.18.4
Signed-off-by: Christina Sørensen <christina@cafkafk.com>
2024-02-22 06:31:29 +01:00
.github build(deps): bump webiny/action-conventional-commits from 1.2.0 to 1.3.0 2024-02-06 19:42:19 +01:00
benches refactor: fix rustfmt issues and place skips where needed 2023-09-23 19:11:19 +02:00
completions fix: duplicates in shell completions 2024-02-12 10:01:17 +01:00
devtools test: updated tests to fit new features 2024-01-06 11:14:07 +01:00
docs feat(docs): demo gif and gif generation recipe 2023-11-04 13:31:30 +01:00
man feat(flags)!: add --classify=always,auto,never 2024-01-28 09:37:19 +01:00
snap fix(snap): fix snapcraft.yaml formatting 2023-11-12 08:41:04 +01:00
src fix: classification width should be taken into account with -F=auto 2024-02-17 10:34:53 -05:00
tests test: regenerate classification related tests 2024-01-28 09:37:19 +01:00
.envrc fix: Avoid direnv error if nix isn't installed 2023-09-01 07:03:10 +02:00
.git-blame-ignore-revs chore(git): ignore blame from #644 2023-11-13 17:45:52 +01:00
.gitignore feat(input): adding piping of args 2023-11-22 16:42:10 +01:00
CHANGELOG.md chore: release eza v0.18.4 2024-02-22 06:31:29 +01:00
CODE_OF_CONDUCT.md doc: add CODE_OF_CONDUCT.md 2023-07-30 11:47:01 +02:00
CONTRIBUTING.md chore(github): improve the PR template 2023-11-04 09:46:26 +01:00
Cargo.lock chore: release eza v0.18.4 2024-02-22 06:31:29 +01:00
Cargo.toml chore: release eza v0.18.4 2024-02-22 06:31:29 +01:00
INSTALL.md docs: add target arch to deb PPA installation for strict apt environments 2024-02-12 10:06:23 +01:00
Justfile chore(checksum): adding blake3 to checksums 2024-01-06 11:11:33 +01:00
LICENCE Update LICENCE 2014-07-02 22:07:09 +01:00
README.md feat(flags)!: add --classify=always,auto,never 2024-01-28 09:37:19 +01:00
SECURITY.md doc: Create SECURITY.md 2023-08-07 19:29:32 +00:00
build.rs refactor: fix rustfmt issues and place skips where needed 2023-09-23 19:11:19 +02:00
cliff.toml build(release): improve release automation 2023-10-04 13:29:27 +02:00
deb.asc doc: add gpg public key for the deb repository 2023-08-20 14:57:12 +02:00
deny.toml style: formatted using treefmt 2023-09-18 23:23:44 +02:00
flake.lock build(flake): change flake inputs 2024-01-27 15:49:19 +01:00
flake.nix build(flake): change flake inputs 2024-01-27 15:49:19 +01:00
powertest.yaml feat(flags)!: add --classify=always,auto,never 2024-01-28 09:37:19 +01:00
rust-toolchain.toml style: formatted using treefmt 2023-09-18 23:23:44 +02:00
rustfmt.toml build(rustfmt): add empty rustfmt to ensure project specific settings 2024-02-02 15:02:34 +01:00
treefmt.nix test(powertest): powertests using generated testdirs 2023-11-13 17:41:03 +01:00

README.md

eza

A modern, maintained replacement for ls.

Gitter

Built with Nix Contributor Covenant

Unit tests Crates.io Crates.io

eza demo gif


eza is a modern, maintained replacement for the venerable file-listing command-line program ls that ships with Unix and Linux operating systems, giving it more features and better defaults. It uses colours to distinguish file types and metadata. It knows about symlinks, extended attributes, and Git. And its small, fast, and just one single binary.

By deliberately making some decisions differently, eza attempts to be a more featureful, more user-friendly version of ls.


eza features not in exa (non-exhaustive):

  • Fixes “The Grid Bug” introduced in exa 2021.
  • Hyperlink support.
  • Mount point details.
  • Selinux context output.
  • Git repo status output.
  • Human readable relative dates.
  • Several security fixes.
  • Support for bright terminal colours.
  • Many smaller bug fixes/changes!

...and like, so much more that it became exhausting to update this all the time. Like seriously, we have a lot of good stuff.


Try it!

Nix ❄️

If you already have Nix setup with flake support, you can try out eza with the nix run command:

nix run github:eza-community/eza

Nix will build eza and run it.

If you want to pass arguments this way, use e.g. nix run github:eza-community/eza -- -ol.

Installation

eza is available for Windows, macOS and Linux. Platform and distribution specific installation instructions can be found in INSTALL.md.

Packaging status


Click sections to expand.

Command-line options

Command-line options

ezas options are almost, but not quite, entirely unlike lss.

Display options

  • -1, --oneline: display one entry per line
  • -G, --grid: display entries as a grid (default)
  • -l, --long: display extended details and attributes
  • -R, --recurse: recurse into directories
  • -T, --tree: recurse into directories as a tree
  • -x, --across: sort the grid across, rather than downwards
  • -F, --classify=(when): display type indicator by file names (always, auto, never)
  • --colo[u]r=(when): when to use terminal colours (always, auto, never)
  • --colo[u]r-scale=(field): highlight levels of field distinctly(all, age, size)
  • --color-scale-mode=(mode): use gradient or fixed colors in --color-scale. valid options are fixed or gradient
  • --icons=(when): when to display icons (always, auto, never)
  • --hyperlink: display entries as hyperlinks
  • -w, --width=(columns): set screen width in columns

Filtering options

  • -a, --all: show hidden and 'dot' files
  • -d, --list-dirs: list directories like regular files
  • -L, --level=(depth): limit the depth of recursion
  • -r, --reverse: reverse the sort order
  • -s, --sort=(field): which field to sort by
  • --group-directories-first: list directories before other files
  • -D, --only-dirs: list only directories
  • -f, --only-files: list only files
  • --git-ignore: ignore files mentioned in .gitignore
  • -I, --ignore-glob=(globs): glob patterns (pipe-separated) of files to ignore

Pass the --all option twice to also show the . and .. directories.

Long view options

These options are available when running with --long (-l):

  • -b, --binary: list file sizes with binary prefixes
  • -B, --bytes: list file sizes in bytes, without any prefixes
  • -g, --group: list each files group
  • -h, --header: add a header row to each column
  • -H, --links: list each files number of hard links
  • -i, --inode: list each files inode number
  • -m, --modified: use the modified timestamp field
  • -M, --mounts: Show mount details (Linux and MacOS only).
  • -S, --blocksize: show size of allocated file system blocks
  • -t, --time=(field): which timestamp field to use
  • -u, --accessed: use the accessed timestamp field
  • -U, --created: use the created timestamp field
  • -X, --dereference: dereference symlinks for file information
  • -Z, --context: list each files security context
  • -@, --extended: list each files extended attributes and sizes
  • --changed: use the changed timestamp field
  • --git: list each files Git status, if tracked or ignored
  • --git-repos: list each directorys Git status, if tracked
  • --git-repos-no-status: list whether a directory is a Git repository, but not its status (faster)
  • --no-git: suppress Git status (always overrides --git, --git-repos, --git-repos-no-status)
  • --time-style: how to format timestamps. valid timestamp styles are default, iso, long-iso, full-iso, relative, or a custom style +<FORMAT> (E.g., +%Y-%m-%d %H:%M => 2023-09-30 13:00. For more specifications on the format string, see the eza(1) manual page and chrono documentation.).
  • --total-size: show recursive directory size
  • --no-permissions: suppress the permissions field
  • -o, --octal-permissions: list each file's permission in octal format
  • --no-filesize: suppress the filesize field
  • --no-user: suppress the user field
  • --no-time: suppress the time field
  • --stdin: read file names from stdin

Some of the options accept parameters:

  • Valid --colo[u]r options are always, automatic (or auto for short), and never.
  • Valid sort fields are accessed, changed, created, extension, Extension, inode, modified, name, Name, size, type, and none. Fields starting with a capital letter sort uppercase before lowercase. The modified field has the aliases date, time, and newest, while its reverse has the aliases age and oldest.
  • Valid time fields are modified, changed, accessed, and created.
  • Valid time styles are default, iso, long-iso, full-iso, and relative.

Hacking on eza

If you wanna contribute to eza, firstly, you're expected to follow our code of conduct. After having understood the code of conduct, you can have a look at our CONTRIBUTING.md for more info about actual hacking.

Star History Chart