eza

A modern replacement for ls.

---

ezais a modern, maintained replacement for the venerable file-listing command-line programlsthat 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 it’ssmall,fast,and justone single binary.

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

---

ezafeatures 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 forbrightterminal 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 thenix runcommand:

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 inINSTALL.md.

---

Command-line options

eza’s options are almost, but not quite, entirely unlikels’s. Quick overview:

Display options

Click to expand

• -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 offielddistinctly(all, age, size)
• --color-scale-mode=(mode):use gradient or fixed colors in --color-scale. valid options arefixedorgradient
• --icons=(when):when to display icons (always, auto, never)
• --hyperlink:display entries as hyperlinks
• --absolute=(mode):display entries with their absolute path (on, follow, off)
• -w,--width=(columns):set screen width in columns

Filtering options

Click to expand

• -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
• --no-symlinks:don't show symbolic links
• --show-symlinks:explicitly show links (with--only-dirs,--only-files,to show symlinks that match the filter)
• --git-ignore:ignore files mentioned in.gitignore
• -I,--ignore-glob=(globs):glob patterns (pipe-separated) of files to ignore

Pass the--alloption twice to also show the.and..directories.

Long view options

Click to expand

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 file’s group
• -h,--header:add a header row to each column
• -H,--links:list each file’s number of hard links
• -i,--inode:list each file’s 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 file’s security context
• -@,--extended:list each file’s extended attributes and sizes
• --changed:use the changed timestamp field
• --git:list each file’s Git status, if tracked or ignored
• --git-repos:list each directory’s 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 theeza(1)manual pageandchrono 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]roptions arealways,automatic(orautofor short), andnever.
• Valid sort fields areaccessed,changed,created,extension,Extension,inode,modified,name,Name,size,type,andnone.Fields starting with a capital letter sort uppercase before lowercase. The modified field has the aliasesdate,time,andnewest,while its reverse has the aliasesageandoldest.
• Valid time fields aremodified,changed,accessed,andcreated.
• Valid time styles aredefault,iso,long-iso,full-iso,andrelative.

See themanpages for further documentation of usage. They are available

• onlinein the repo
• in your terminal viaman eza,as of version[0.18.13] - 2024-04-25

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.