Scroll to navigation

ANSILOVE(1) General Commands Manual ANSILOVE(1)


ansiloveANSI / ASCII art to PNG converter


ansilove [-dhiqrsSv] [-b bits] [-c columns] [-f font] [-m mode] [-o file] [-R factor] [-t type] file


ansilove is an ANSI / ASCII art to PNG converter, allowing to convert ANSI and artscene-related file formats into PNG images, supporting ANSI (.ANS), PCBoard (.PCB), Binary (.BIN), Artworx (.ADF), iCE Draw (.IDF), Tundra (.TND) and XBin (.XB) formats.

It creates size optimized 4-bit PNG files and supports SAUCE (Standard Architecture for Universal Comment Extensions), 80x25 and 80x50 PC fonts (including all the 14 MS-DOS charsets), Amiga fonts, and iCE colors.

The options are as follows:

Set to 9 to render 9th column of block characters (default: 8).
Adjust number of columns for ANSI, BIN, and TND files.
Enable DOS aspect ratio.
Select font for supported formats.

Valid options for PC fonts are:

Default (Code page 437)
80x50 mode (Code page 437)
Greek (Code page 737)
Baltic (Code page 775)
Latin1 (Code page 850)
Latin2 (Code page 852)
Cyrillic (Code page 855)
Turkish (Code page 857)
Portuguese (Code page 860)
Icelandic (Code page 861)
Hebrew (Code page 862)
French Canadian (Code page 863)
Nordic (Code page 865)
Russian (Code page 866)
Greek (Code page 869)
Terminus (Modern font, code page 437)

Valid options for Amiga fonts are:

Alias to Topaz, see below
Original MicroKnight version
Modified MicroKnight version
Original mO'sOul font
Original P0T-NOoDLE font
Original Topaz Kickstart 2.x version
Modified Topaz Kickstart 2.x+ version
Original Topaz Kickstart 1.x version
Modified Topaz Kickstart 1.x version
Show help.
Enable iCE colors.
Set rendering mode for ANS files.

Valid options are:

Black on gray, with 78 columns.
Render with transparent background.
Use Amiga Workbench palette.
Specify output filename/path.
Suppress output messages (quiet).
Create Retina @2x output file.
Create Retina output file with custom scale factor.
Specify input file type.

Valid types are:

ANSi (ANSI escape sequences: ANSI X3.64 standard)
Artworx format, supporting custom character sets and palettes
Binary format (raw memory copy of text mode video memory)
iCE Draw format, supporting custom character sets and palettes
PCBoard Bulletin Board System (BBS) own file format
TundraDraw format, supporting 24-bit color mode
XBin format, supporting custom character sets and palettes
Show SAUCE record without generating output.
If available, use SAUCE info for render options (ex: width).
Show version information.


To render a file with iCE colors enabled:

$ ansilove -i file.ans

To create a Retina @2x output file:

$ ansilove -r file.ans

To creates a Retina output file with a custom scale factor:

$ ansilove -R 3 file.ans

To only display SAUCE record without generating output:

$ ansilove -s file.ans
To render a file with transparent background:

$ ansilove -m transparent file.ans

To render a file using a custom font:

$ ansilove -f amiga file.txt

To render a file using a custom font, rendering the 9th column, enabling iCE colors, and using DOS aspect ratio:

$ ansilove -f 80x50 -b 9 -d -i file.ans


ansilove was written by Stefan Vogt, Brian Cassidy, and Frederic Cambus.

August 28, 2020 Debian