LSDeluxe: next gen ls command

To update or switch versions, run webi lsd@stable (or @v0.20, @beta, etc).



Cheat Sheet

lsd is a modern, cross-platform, drop-in replacement for ls. It does everything that you expect it to, plus modern extras that you can check out with lsd --help.

Note: You must install the nerdfont and update the font in your Terminal for lsd to show icons.

Run lsd exactly as you would ls:


But wait, there's more, you can tree as well:

lsd --tree

How to turn off icons and colors

If you just want the benefits of a cross-platform ls without having to install nerdfont or needing a modern terminal, you've got options:

lsd --icon=never --color=never

Since that can be a little awkward to type over and over, you can use an alias:

alias lsd=lsd --icon=never --color=never

(you may also enjoy aliasman)

Or update the config file:


classic: true

How to alias as ls, ll, la, etc

This will affect the interactive shell, but not scripts.

Using aliasman:

aliasman ls "lsd -F"
aliasman la "lsd -AF"
aliasman ll "lsd -lAF"
aliasman lg "lsd -F --group-dirs=first"

(and follow the on-screen instructions or restart your shell)

Or manually update your .bashrc, .zshrc, or .profile

alias ls="lsd -F"
alias la="lsd -AF"
alias ll="lsd -lAF"
alias lg="lsd -F --group-dirs=first"

For situations in which you must use ls exactly, remember that you can escape the alias:

\ls -lAF

How to alias as tree

Using aliasman:

aliasman tree "lsd -AF --tree"
alias tree="lsd -AF --tree"

Or manually update your .bashrc, .zshrc, or .profile

alias tree="lsd -AF --tree"

And when you want to use GNU tree you can escape the alias in some shells:


Or use the full path:



Report an Issue Submit Installer Star on GitHub