.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "ncls" "1" "v2.2.3" "" ""
.hy
.SH NAME
.PP
ncls - List paths with rendering of multimedia
.SH SYNOPSIS
.PP
\f[B]ncls\f[R]\ [\f[B]-h\f[R]|\f[B]--help\f[R]]\ [\f[B]-V\f[R]|\f[B]--version\f[R]]
[\f[B]-d\f[R]] [\f[B]-l\f[R]]\ [\f[B]-L\f[R]] [\f[B]-R\f[R]]
[\f[B]-a\f[R]|\f[B]--align\f[R] \f[B]\f[BI]type\f[B]\f[R]] [\f[B]-b\f[R]
\f[B]\f[BI]blitter\f[B]\f[R]] [ paths ]
.SH DESCRIPTION
.PP
\f[B]ncls\f[R] uses a multimedia-enabled notcurses to list paths,
similarly to the \f[B]ls(1)\f[R] command, rendering images and videos to
a terminal.
.SH OPTIONS
.PP
\f[B]-d\f[R]: list directories themselves, not their contents.
.PP
\f[B]-l\f[R]: use a long listing format.
.PP
\f[B]-L\f[R]: when showing file information for a symbolic link, show
information for the file the link references rather than for the link
itself.
.PP
\f[B]-R\f[R]: list subdirectories recursively.
.PP
\f[B]-V\f[R]|\f[B]--version\f[R]: Print version information, and exit
with success.
.PP
\f[B]-h\f[R]|\f[B]--help\f[R]: Print help information, and exit with
success.
.PP
\f[B]-a\f[R]|\f[B]--align\f[R] \f[B]\f[BI]type\f[B]\f[R]: Align images
on \f[B]left\f[R], \f[B]center\f[R], or \f[B]right\f[R].
.PP
\f[B]-b\f[R]|\f[B]--blitter\f[R] \f[B]\f[BI]blitter\f[B]\f[R]: Blitter,
one of \f[B]ascii\f[R], \f[B]half\f[R], \f[B]quad\f[R], \f[B]sex\f[R],
\f[B]braille\f[R], or \f[B]pixel\f[R].
.PP
paths: Run on the specified paths.
If none are supplied, run on the current directory.
.SH NOTES
.PP
Optimal display requires a terminal advertising the \f[B]rgb\f[R]
terminfo(5) capability, or that the environment variable
\f[B]COLORTERM\f[R] is defined to \f[B]24bit\f[R] (and that the terminal
honors this variable), along with a fixed-width font with good coverage
of the Unicode Block Drawing Characters.
.SH SEE ALSO
.PP
\f[B]notcurses(3)\f[R], \f[B]notcurses_visual(3)\f[R],
\f[B]terminfo(5)\f[R], \f[B]unicode(7)\f[R]
.SH AUTHORS
nick black <nickblack@linux.com>.