notcurses/doc/man/man1/ncls.1.md
nick black be4a9154a8
v2.2.1
2021-02-09 19:34:03 -05:00

1.4 KiB

% ncls(1) % nick black nickblack@linux.com % v2.2.1

NAME

ncls - List paths with rendering of multimedia

SYNOPSIS

ncls [-h|--help] [-V|--version] [-d] [-l] [-L] [-R] [-a|--align type] [ paths ]

DESCRIPTION

ncls uses a multimedia-enabled notcurses to list paths, similarly to the ls(1) command, rendering images and videos to a terminal.

OPTIONS

-d: list directories themselves, not their contents.

-l: use a long listing format.

-L: when showing file information for a symbolic link, show information for the file the link references rather than for the link itself.

-R: list subdirectories recursively.

-V|--version: Print version information, and exit with success.

-h|--help: Print help information, and exit with success.

-a|--align type: Align images on left, center, or right.

paths: Run on the specified paths. If none are supplied, run on the current directory.

NOTES

Optimal display requires a terminal advertising the rgb terminfo(5) capability, or that the environment variable COLORTERM is defined to 24bit (and that the terminal honors this variable), along with a fixed-width font with good coverage of the Unicode Block Drawing Characters.

SEE ALSO

notcurses(3), notcurses_visual(3), terminfo(5), unicode(7)