Scroll to navigation

ANSILOVE(1) General Commands Manual ANSILOVE(1)

NAME

ansilove
ANSI / ASCII art to PNG converter

SYNOPSIS

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

DESCRIPTION

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:

bits
Set to 9 to render 9th column of block characters (default: 8).
columns
Adjust number of columns for ANSI, BIN, and TND files.
Enable DOS aspect ratio.
font
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.
mode
Set rendering mode for ANS files.

Valid options are:

Black on gray, with 78 columns.
Render with transparent background.
Use Amiga Workbench palette.
file
Specify output filename/path.
Suppress output messages (quiet).
Create Retina @2x output file.
factor
Create Retina output file with custom scale factor.
type
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.

EXAMPLES

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

AUTHORS

ansilove was written by Stefan Vogt, Brian Cassidy, and Frederic Cambus.
August 28, 2020 Linux 4.19.0-14-amd64