README.md 3.1 KB

eza plugin

This provides aliases that invoke the eza utility rather than ls

To use it add eza to the plugins array in your zshrc file:

plugins=(... eza)

Configuration

All configurations are done using the zstyle command in the :omz:plugins:eza namespace.

NOTE: The configuring needs to be done prior to OMZ loading the plugins. When the plugin is loaded, changing the zstyle won't have any effect.

dirs-first

zstyle ':omz:plugins:eza' 'dirs-first' yes|no

If yes, directories will be grouped first.

Default: no

git-status

zstyle ':omz:plugins:eza' 'git-status' yes|no

If yes, always add --git flag to indicate git status (if tracked / in a git repo).

Default: no

header

zstyle ':omz:plugins:eza' 'header' yes|no

If yes, always add -h flag to add a header row for each column.

Default: no

show-group

zstyle ':omz:plugins:eza' 'show-group' yes|no

If yes (default), always add -g flag to show the group ownership.

Default: yes

size-prefix

zstyle ':omz:plugins:eza' 'size-prefix' (binary|none|si)

Choose the prefix to be used in displaying file size:

Default: si

time-style

zstyle ':omz:plugins:eza' 'time-style' $TIME_STYLE

Sets the --time-style option of eza. (See man eza for the options)

Default: Not set, which means the default behavior of eza will take place.

Aliases

Notes:

  • Aliases may be modified by Configuration
  • The term "files" without "only" qualifier means both files & directories
Alias Command Description
la eza -la List all files (except . and ..) as a long list
ldot eza -ld .* List dotfiles only (directories shown as entries instead of recursed into)
lD eza -lD List only directories (excluding dotdirs) as a long list
lDD eza -laD List only directories (including dotdirs) as a long list
ll eza -l List files as a long list
ls eza Plain eza call
lsd eza -d List specified files with directories as entries, in a grid
lsdl eza -dl List specified files with directories as entries, in a long list
lS eza -l -ssize List files as a long list, sorted by size
lT eza -l -snewest List files as a long list, sorted by date (newest last)