---
name: "lsd"
section: "1"
platform: "linux"
package: "lsd"
version: "1.2.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/lsd"
---

# lsd(1)

LSDeluxe

## NAME

lsd - LSDeluxe

## SYNOPSIS

`lsd [FLAGS] [OPTIONS] [--] [FILE]...`

## DESCRIPTION

lsd is a ls command with a lot of pretty colours and some other stuff to enrich and enhance the directory listing experience.

## OPTIONS

- `-a`, `--all`

  Do not ignore entries starting with **.**

- `-A`, `--almost-all`

  Do not list implied **.** and **..**

- `--classic`

  Enable classic mode (no colours or icons)

- `-L`, `--dereference`

  When showing file information for a symbolic link, show information for the file the link references rather than for the link itself

- `-d`, `--directory-only`

  Display directories themselves, and not their contents (recursively when used with –tree)

- `-X`, `--extensionsort`

  Sort by file extension

- `--git`

  Display git status. Directory git status is a reduction of included file statuses (recursively).

- `--help`

  Prints help information

- `-h`, `--human-readable`

  For ls compatibility purposes ONLY, currently set by default

- `--ignore-config`

  Ignore the configuration file

- `--config-file <path>`

  Provide the config file from a custom location

- `-F`, `--classify`

  Append indicator (one of \*/=\>@\|) at the end of the file names

- `-i`, `--inode`

  Display the index number of each file

- `-l`, `--long`

  Display extended file metadata as a table

- `--no-symlink`

  Do not display symlink target

- `-1`, `--oneline`

  Display one entry per line

- `-R`, `--recursive`

  Recurse into directories

- `-r`, `--reverse`

  Reverse the order of the sort

- `-S`, `--sizesort`

  Sort by size

- `-t`, `--timesort`

  Sort by time modified

- `--total-size`

  Display the total size of directories

- `--tree`

  Recurse into directories and present the result as a tree

- `-V`, `--version`

  Prints version information

- `-v`, `--versionsort`

  Natural sort of (version) numbers within text

- `--blocks <blocks>...`

  Specify the blocks that will be displayed and in what order \[possible values: permission, user, group, size, date, name, inode, git\]

- `--color <color>...`

  When to use terminal colours \[default: auto\] \[possible values: always, auto, never\]

- `--date <date>...`

  How to display date \[possible values: date, locale, relative, +date-time-format\] \[default: date\]

- `--depth <num>...`

  Stop recursing into directories after reaching specified depth

- `--group-dirs <group-dirs>...`

  Sort the directories then the files \[default: none\] \[possible values: none, first, last\]

- `--group-directories-first`

  Groups the directories at the top before the files. Same as `--group-dirs=first`

- `--hyperlink <hyperlink>...`

  Attach hyperlink to filenames \[default: never\] \[possible values: always, auto, never\]

- `--icon <icon>...`

  When to print the icons \[default: auto\] \[possible values: always, auto, never\]

- `--icon-theme <icon-theme>...`

  Whether to use fancy or unicode icons \[default: fancy\] \[possible values: fancy, unicode\]

- `-I, --ignore-glob <pattern>...`

  Do not display files/directories with names matching the glob pattern(s). More than one can be specified by repeating the argument \[default: \]

- `--permission <permission>...`

  How to display permissions \[default: rwx for linux, attributes for windows\] \[possible values: rwx, octal, attributes, disable\]

- `--size <size>...`

  How to display size \[default: default\] \[possible values: default, short, bytes\]

- `--sort <WORD>...`

  Sort by WORD instead of name \[possible values: size, time, version, extension, git\]

- `-U`, `--no-sort`

  Do not sort. List entries in directory order

- `-Z` `--context`

  Display SELinux or SMACK security context

- `--header`

  Display block headers

- `-N --literal`

  Print entry names without quoting

- `--truncate-owner-after`

  Truncate the user and group names if they exceed a certain number of characters

- `--truncate-owner-marker`

  Truncation marker appended to a truncated user or group name

## ARGS

- `<FILE>...`

  A file or directory to list \[default: .\]

## EXAMPLES

- `lsd`

  Display listing for current directory

- `lsd /etc`

  Display listing of /etc

- `lsd -la`

  Display listing of current directory, including files starting with `.` and the current directory’s entry.

## ENVIRONMENT

- `LS_COLORS`

  Used to determine color for displaying filenames. See **dir\_colors**.

- `XDG_CONFIG_HOME`

  Used to locate optional config file. If `XDG_CONFIG_HOME` is set, use `$XDG_CONFIG_HOME/lsd/config.yaml` else `$HOME/.config/lsd/config.yaml`.

- `SHELL_COMPLETIONS_DIR` or `OUT_DIR`

  Used to specify the directory for generating a shell completions file. If neither are set, no completions file will be generated. The directory will be created if it does not exist.