mirror of
https://github.com/lsd-rs/lsd
synced 2024-12-15 06:22:47 +00:00
3.4 KiB
3.4 KiB
title | section | header | footer | date |
---|---|---|---|---|
lsd | 1 | User Manual | lsd <version> | <date> |
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
--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]
--color <color>...
- When to use terminal colours [default: auto] [possible values: always, auto, never]
--date <date>...
- How to display date [possible values: date, 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]
--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: ]
--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]
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
.