CHAFA(1) User Commands CHAFA(1) (NAME) chafa - (SYNOPSIS) chafa [OPTION...] [IMAGE...] (DESCRIPTION) chafa GIF ANSI/Unicode . . . (GENERAL OPTIONS) --files path path '-' (stdin). (newline) . . . --files0 path path '-' (stdin). NUL . ( POSIX) . : find . -type f -print0 | chafa --files0 - . . -h, --help . --probe arg [auto, on, off]. . 5.0 . --probe-mode mode [any, ctty, stdio]. "any" . "ctty" ( /dev/tty) chafa () . "stdio" / . --version . (OUTPUT ENCODING) -f, --format format [iterm, kitty, sixels, symbols]. iterm kitty sixels symbols (" ANSI") . -O num, --optimize num [0-9]. 0 9 . 5 "-c none" 0 . --relative bool [on, off]. . 'less -R'. off . --passthrough mode [auto, none, screen, tmux]. . auto Kitty . -f . --polite bool [on, off]. . off . (SIZE AND LAYOUT) --align ALIGN (viewport). : left right top bottom hcenter vcenter center. "center,right". "center" "hcenter" . "center,center" . "--clear" - "--relative on". -C bool, --center bool [on, off]. off . "--align center" . --clear . --exact-size mode [auto, on, off]. . auto ( /padding) . . auto . --fit-width . --font-ratio width/height . . 1/2 . (symbol mode) . --grid colsxrows cols rows . cols rows --grid 4 --grid x4 . "auto" . -g "--grid auto". --label bool [on, off]. . off . -l "--label on". --margin-bottom num . . 1 . --margin-right num . 0 . --scale num . 1.0 . "max" . 1.0 4.0 . -s widthxheight, --size widthxheight . ( --view-size ). --stretch . --scale max . --view-size widthxheight . 80x25 . ( 80x x25) . (ANIMATION AND TIMING) --animate bool [on, off]. on . . -d, --duration seconds . . "inf" . . " (DURATION)" . --speed speed . ( ) "fps" . --watch . --duration . (COLORS AND PROCESSING) --bg color ( ). . X.Org . (black) ( --probe ). -c mode, --colors mode [none, 2, 8, 16/8, 16, 240, 256, full]. . aixterm . 16/8 "" "bold" . ANSI "none" . sixel "full" . . "none" "2" / ( --fg --bg ). . --color-extractor extractor [average, median]. (median) (average) . average . --color-space cs [rgb, din99d]. rgb . --dither type (dithering) . [none, ordered, diffusion, noise]. "Bayer" "ordered" "fs" (Floyd-Steinberg) "diffusion" . sixel "noise" "none" . --dither-grain widthxheight . width x height [1, 2, 4, 8] . . 4x4 1x1 sixel . --dither-intensity intensity . 0.0 1.0 . . 10.0 . --fg color ( ). --bg 2 none . X.Org . (white) ( --probe ). --invert . 2 none . --fg --bg . -p bool, --preprocess bool [on, off]. on off . . -t threshold, --threshold threshold [0.0 - 1.0]. 0.0 1.0 ( --bg). (RESOURCE ALLOCATION) --threads num (threads) . CPU . -w num, --work num CPU [1-9]. 1 9 . 5 . (EXTRA OPTIONS FOR SYMBOL ENCODING) --fg-only . . --fill symbols /. none . --symbols . --glyph-file file FreeType ( TTF PCF ). . . . . --symbols symbols . . (EXIT STATUS) chafa 0 1 2 ( ). 0 1 2 (SYMBOLS) --symbols --fill : [all, none, space, solid, stipple, block, border, diagonal, dot, quad, half, hhalf, vhalf, inverted, braille, technical, geometric, ascii, legacy, sextant, wedge, wide, narrow]. (diagonals) (borders) . "u" "ue080" ".." "u100..u200". UTF-8 [abcd]. . + - . . block+border+space-wide-inverted "none" block+border+space-wide ( ). (DURATION) : 1. --duration . 2. ( ) . 3. ( ) . (EXAMPLES) chafa in.gif GIF . ( ctrl-c) . . chafa -c full -s 200 in.gif (truecolor) . chafa -c 16 --color-space din99d --symbols -dot in.jpg (dot). chafa -c none --symbols block+border-solid in.png (solid). (FURTHER READING) Chafa[1] . (AUTHOR) Hans Petter Jansson[2] . (NOTES) 1. Chafa https://hpjansson.org/chafa 2. Hans Petter Jansson https://hpjansson.org chafa CHAFA(1)