---
name: "ansilove"
section: "1"
platform: "linux"
package: "ansilove"
version: "4.2.0-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ansilove"
---

# ansilove(1)

ANSI / ASCII art to PNG converter

## 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:

- **-b** *bits*

  Set to 9 to render 9th column of block characters (default: 8).

- **-c** *columns*

  Adjust number of columns for ANSI, BIN, and TND files.

- **-d**

  Enable DOS aspect ratio.

- **-f** *font*

  Select font for supported formats.

  Valid options for PC fonts are:

  - **80x25**

    Default (Code page 437)

  - **80x50**

    80x50 mode (Code page 437)

  - **cp737**

    Greek (Code page 737)

  - **cp775**

    Baltic (Code page 775)

  - **cp850**

    Latin1 (Code page 850)

  - **cp852**

    Latin2 (Code page 852)

  - **cp855**

    Cyrillic (Code page 855)

  - **cp857**

    Turkish (Code page 857)

  - **cp860**

    Portuguese (Code page 860)

  - **cp861**

    Icelandic (Code page 861)

  - **cp862**

    Hebrew (Code page 862)

  - **cp863**

    French Canadian (Code page 863)

  - **cp865**

    Nordic (Code page 865)

  - **cp866**

    Russian (Code page 866)

  - **cp869**

    Greek (Code page 869)

  - **terminus**

    Terminus (Modern font, code page 437)

    Valid options for Amiga fonts are:

    - **amiga**

      Alias to Topaz, see below

    - **microknight**

      Original MicroKnight version

    - **microknight+**

      Modified MicroKnight version

    - **mosoul**

      Original mO'sOul font

    - **pot-noodle**

      Original P0T-NOoDLE font

    - **topaz**

      Original Topaz Kickstart 2.x version

    - **topaz+**

      Modified Topaz Kickstart 2.x+ version

    - **topaz500**

      Original Topaz Kickstart 1.x version

    - **topaz500+**

      Modified Topaz Kickstart 1.x version

- **-h**

  Show help.

- **-i**

  Enable iCE colors.

- **-m** *mode*

  Set rendering mode for ANS files.

  Valid options are:

  - **ced**

    Black on gray, with 78 columns.

  - **transparent**

    Render with transparent background.

  - **workbench**

    Use Amiga Workbench palette.

- **-o** *file*

  Specify output filename/path.

- **-q**

  Suppress output messages (quiet).

- **-r**

  Create Retina @2x output file.

- **-R** *factor*

  Create Retina output file with custom scale factor.

- **-t** *type*

  Specify input file type.

  Valid types are:

  - **ans**

    ANSi (ANSI escape sequences: ANSI X3.64 standard)

  - **adf**

    Artworx format, supporting custom character sets and palettes

  - **bin**

    Binary format (raw memory copy of text mode video memory)

  - **idf**

    iCE Draw format, supporting custom character sets and palettes

  - **pcb**

    PCBoard Bulletin Board System (BBS) own file format

  - **tnd**

    TundraDraw format, supporting 24-bit color mode

  - **xb**

    XBin format, supporting custom character sets and palettes

- **-s**

  Show SAUCE record without generating output.

- **-S**

  If available, use SAUCE info for render options (ex: width).

- **-v**

  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.