ansifilter man page

Ansifilter — ANSI escape code processor and converter


ansifilter [d:i:F:m:o:r:s:e:fhptvHRT] [-i input file] [-o output file] [--text] [--html] [--latex] [--tex] [--rtf] [input files]


Ansifilter is a small utility to handle text files containing ANSI terminal escape codes. The command sequences may be stripped or be interpreted to generate formatted output (HTML, LaTeX, TeX, RTF).

See the README file for details.

File options

-i, --input=<file>

Name of input file

-o, --output=<file>

Name of output file

-O, --outdir=<dir>

Name of output directory

-t, --tail

Continue reading after end-of-file (like tail -f). Use system tail if available.

Output formats

-T, --text

Output text (default)

-H, --html

Output HTML

-M, --pango

Output Pango markup

-L, --latex

Output LaTeX

-P, --tex

Output Plain TeX

-R, --rtf

Output RTF

-B, --bbcode

Output BBCode

Format options

 -a, --anchors

Add HTML line anchors (assumes -l)

-d, --doc-title

Set HTML/LaTeX document title

-f, --fragment

Omit HTML header and footer

-F, --font=<font>

Set HTML/RTF font face

-l, --line-numbers

Print line numbers in output file

-m, --map=<path>

Read color mapping file (see README)

-r, --style-ref=<rf>

Set HTML/TeX/LaTeX stylesheet path

-s, --font-size=<num?>

Set HTML/RTF font size

-e, --encoding=<enc>

Set HTML encoding (must match input file encoding); omit encoding information if enc=NONE

-p, --plain

Ignore ANSI formatting information

-w, --wrap=<len>

Wrap long lines


Omit trailing newline


Omit line numbers of wrapped lines (assumes -l)

ASCII art options


Parse codepage 437 ASCII art (HTML, RTF output only)


Parse BIN/XBIN ASCII art (HTML, RTF output only)


Parse Tundra ANSI art (HTML, RTF output only)


Set ASCII art width (default 80)


Set ASCII art height (default 150)

Other Options

-h, --help

print help

-v, --version

print version and license info

If no in- or output files are specified, stdin and stdout will be used for  in- or output. Plain text will be generated, if no output format is given. Parsing XBIN files overrides --art-width, --art-height and --map options.


File conversions:

ansifilter -i text_with_ansi.txt -o text_without_ansi.txt

tail -f server.log | ansifilter

ansifilter *.txt


Andre Simon <>

See Also

More information at


2017-07-20 Andre Simon user documentation