lsd(1) | User Manual | lsd(1) |
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
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.
lsd |