Ansifilter Save Abandoned
ANSI sequence filter
*** Since Github is now part of Mordor Corp, the ansifilter Git repo *** *** moved to https://gitlab.com/saalen/ansifilter ***
--- ANSIFILTER MANUAL - Version 2.9 ---------------------- NOVEMBER 2017 ---
OSI Certified Open Source Software
Ansifilter handles text files containing ANSI terminal escape codes. The command sequences may be stripped or be interpreted to generate formatted output (HTML, RTF, TeX, LaTeX, BBCode, Pango).
CONTENT:
-
Quick introduction
-
Platforms
-
Features
-
Environment variables
-
Color mapping
-
Contact
-
Quick introduction
Invocation: ansifilter [OPTION]... [FILE]...
ansifilter handles text files containing ANSI terminal escape codes.
File handling:
-i, --input=
Output text formats: -T, --text (default) Output text -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
-e, --encoding Set HTML/RTF encoding (must match input file encoding)
-f, --fragment Omit HTML header and footer
-F, --font= Set HTML/RTF font face
-l, --line-numbers Print line numbers in output file
-m, --map=
ANSI art options: --art-cp437 Parse codepage 437 ANSI art (HTML, RTF output) --art-bin Parse BIN/XBIN ANSI art (HTML output, no stdin) --art-tundra Parse Tundra ANSI art (HTML output, no stdin) --art-width Set ANSI art width (default 80) --art-height Set ANSI art height (default 150)
Other options: -h, --help Print help -v, --version Print version and license info
Examples: ansifilter -i input.ansi -o output.txt ansifilter *.txt tail -f server.log | ansifilter
Parsing XBIN files overrides --art-width, --art-height and --map options. The ANSI art file formats BIN, XBIN and TND cannot be read from stdin.
The GUI version (ansifilter-gui) also accepts the first command line argument as input file name.
- Platforms
Ansifilter is currently available for Linux and Win32 platforms.
- Features
Ansifilter understands most CSI sequences. Support for ANSI art files (based on codepage 437 and ANSI.SYS sequences, BIN/XBIN and Tundra files) is enabled with the --art-cp437 and --art-bin options. Parsing XBIN files overrides --art-width, --art-height and --map options. Parsing TND files overrides --art-width and --map options.
Supported SGR parameters:
Formatting: Bold, Underline, Italic, Blink Colors: Black, Red, Green, Yellow, Blue, Magenta, Cyan, White; xterm 256 color modes; 16m true color modes Other: Conceal/Reveal, Image positive/negative
All commands which issue the listed formatting options are supported. Some options like Blink are not supported by all output formats (like RTF).
- ENVIRONMENT VARIABLES
The command line version recognizes these variables:
ANSIFILTER_OPTIONS: may contain command line options, but no input file paths.
- Color mapping
The basic ANSI color set can be adjusted with a color map file (--map option). This text configuration overrides these color codes:
Normal: Black (0), Red (1), Green (2), Yellow (3), Blue (4), Magenta (5), Cyan (6), Gray (7) Bright: DarkGray (8), Red (9), Green (10), Yellow (11), Blue (12), Magenta (13), Cyan (14), White (15)
File format:
<0..15> = <HTML color code>
Example file content:
1= #0000aa 2= #00aa00 3= #00aaaa 4= #aa0000 5= #aa00aa 6= #aa5500 7= #aaaaaa 8= #555555 9= #5555ff 10= #55ff55 11= #55ffff 12= #ff5555 13= #ff55ff 14= #ffff55 15= #ffffff
- Contact
Andre Simon [email protected] http://www.andre-simon.de/
sf.net project with SVN repository, download mirror, bug tracker, help forum: http://sourceforge.net/projects/ansifilter/
Github project with Git repository, bug tracker: https://github.com/andre-simon/ansifilter
Open Source Agenda Badge
