notcurses/doc/man/man1/ncls.1.md
nick black d6d5757b1d
v2.1.1
2020-12-16 17:42:06 -05:00

1.2 KiB

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

NAME

ncls - List paths with rendering of multimedia

SYNOPSIS

ncls [-h] [-d] [-l] [-L] [-R] [--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.

-h: 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)