Commit d2c02d14 authored by TheOuterLinux's avatar TheOuterLinux


parent 56ac4f7a
......@@ -11,6 +11,7 @@ cacaview - ASCII image browser
cadubi - Creative ASCII Drawing Utility By Ian
cat - concatenate files and print on the standard output
catimg - fast image printing in to your terminal
chafa - character art facsimile generator
cowsay/cowthink - configurable speaking/thinking cow (and a bit more)
exiftool - read and write meta information in files
fbi - Linux framebuffer imageviewer
Catimg is good for playing animated GIF's, but tiv for everything else looks much better.
CHAFA(1) User Commands CHAFA(1)
chafa - Character art facsimile generator
chafa [OPTION...] [IMAGE...]
chafa is a utility that converts all kinds of images, including animated GIFs, into
(potentially animated) ANSI/Unicode character output that can be displayed in a terminal.
It supports alpha transparency and multiple color modes and color spaces, and combines a
range of Unicode characters for optimal output.
You can specify one or more input files, but the default behavior is slightly different
with multiple files -- for instance, animations will not loop forever when there is more
than one input file.
--bg color
Background color of display (color name or hex). Partially transparent input will be
blended with this color. Color names are based on those provided with X.Org. Defaults
to black.
Clear screen before processing each file.
-c mode, --colors mode
Set output color mode; one of [none, 2, 16, 240, 256, full]. Defaults to full
(24-bit). The 240-color mode is recommended over the 256-color one, since the lower 16
colors are unreliable and tend to differ between terminals. 16-color mode will use
aixterm extensions to produce 16 foreground and background colors. 2-color mode will
only emit the ANSI codes for reverse color and attribute reset, while "none" will emit
no ANSI color codes whatsoever.
--color-space cs
Color space used for quantization; one of [rgb, din99d]. Defaults to rgb, which is
faster but less accurate.
-d, --duration seconds
Time to show each file. If showing a single file, defaults to zero for a still image
and infinite for an animation. For multiple files, defaults to 3.0. Animations will
always be played through at least once.
--fg color
Foreground color of display (color name or hex). Together with the background color
specified by --bg, this specifies the terminal's palette in color modes 2 and none.
Color names are based on those provided with X.Org. Defaults to white.
--fill symbols
Specify character symbols to use for fill/gradients. Defaults to none. Usage is
similar to that of --symbols; see below.
--font-ratio width/height
Target font's width/height ratio. Can be specified as a real number or a fraction.
Defaults to 1/2.
-h, --help
Show a brief help text.
Invert video. For display with bright backgrounds in color modes 2 and none. Swaps
--fg and --bg.
-p bool, --preprocess bool
Image preprocessing [on, off]. Defaults to on with 16 colors or lower, off otherwise.
This enhances colors and contrast prior to conversion, which can be useful in
low-color modes.
-s widthxheight, --size widthxheight
Set maximum output dimensions in columns and rows. By default this will be the size of
your terminal, or 80x25 if size detection fails.
Stretch image to fit output dimensions; ignore aspect. Implies --zoom.
--symbols symbols
Specify character symbols to employ in final output. See below for full usage and a
list of symbol classes.
-t threshold, --threshold threshold
Threshold above which full transparency will be used [0.0 - 1.0]. Setting this to 0.0
will render a blank image, while a value of 1.0 will replace any transparency with the
background color (configurable with --bg).
Show version, feature and copyright information.
Watch a single input file, redisplaying it whenever its contents change. Will run
until manually interrupted or, if --duration is set, until it expires.
-w num, --work num
How hard to work in terms of CPU and memory [1-9]. 1 is the cheapest, 9 is the most
accurate. Defaults to 5.
Allow scaling up beyond one character per pixel.
Accepted classes for --symbols are [all, none, space, solid, stipple, block, border,
diagonal, dot, quad, half, hhalf, vhalf, inverted, braille, technical, geometric, ascii].
Some symbols belong to multiple classes, e.g. diagonals are also borders.
You can specify a list of classes separated by commas, or prefix them with + and - to add
or remove symbols relative to the existing set. The ordering is significant.
The default symbol set is all-stipple-braille-ascii+space-extra-inverted for all modes
except for "none", which uses all-stipple-braille-ascii+space-extra.
chafa in.gif
Show a potentially animated GIF image in the terminal. If this is an animation, it
will run until the user generates an interrupt (typically ctrl-c). All parameters will
be autodetected based on the current environment.
chafa -c full -s 200 in.gif
Like the above, but force truecolor output that is 200 characters wide and calculate
the height preserving the aspect of the original image.
chafa -c 16 --color-space din99d --symbols -dot in.jpg
Generate 16-color output with perceptual color picking and avoid using dot symbols.
chafa -c none --symbols block+border-solid in.png
Generate uncolored output using block and border symbols, but avoid the solid block
Written by Hans Petter Jansson <>.
chafa CHAFA(1)
......@@ -72,6 +72,7 @@ cc65 - 6502 C compiler (for old systems and game consoles)
ceni - ncurses-based network manager
cfdisk - an ncurses partition editor
cgames - cblocks, cmines, and csokoban
chafa - character art facsimile generator
chmod - change file mode bits (read, write, execute)
chown - change file owner and group
chronos - an ncurses stopwatch/timer
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment