ANSILOVE(1)

✨ ANSILOVE(1) ✨

okay bestie sit DOWN because this is the ansilove manual page, from the General Commands Manual, and it is genuinely iconic 💖

---

🌸 NAME 🌸

ansilove — the ANSI / ASCII art to PNG converter, no cap 🎨➡️🖼️

---

🦋 SYNOPSIS 🦋

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

---

💅 DESCRIPTION 💅

so basically, ansilove is an ANSI / ASCII art to PNG converter, and the way it EATS is that it takes ANSI and artscene-related file formats and turns them into PNG images. it supports ANSI (.ANS), PCBoard (.PCB), Binary (.BIN), Artworx (.ADF), iCE Draw (.IDF), Tundra (.TND) and XBin (.XB) formats. like, the range?? unmatched 💜

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. periodt ✨

the options are as follows, and yes we're going through every single one because you deserve the full tea 🍓

---

🎀 OPTIONS 🎀

• -b bits — set it to 9 to render the 9th column of block characters (default: 8). it's giving precision 😌
• -c columns — adjust the number of columns for ANSI, BIN, and TND files.
• -d — enable DOS aspect ratio. the retro vibe check 🕹️
• -f font — pick the 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)
• spleen — Spleen (Modern font, code page 437)
• 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

look at all those little guys 🧚 lowkey a whole personality quiz

• -h — show help. your bestie when you're lost 🫶
• -i — enable iCE colors. fancy 💅
• -m mode — set the 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. name her, give her an identity ✨
• -q — suppress output messages (quiet). stealth mode, not a word 🤫
• -r — create Retina @2x output file. crisp, obviously 💎
• -R factor — create a Retina output file with a custom scale factor.
• -t type — specify the 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. just reading, not touching 🙈
• -S — if available, use SAUCE info for render options (ex: width).
• -v — show version information. know your roots 🌈

---

🔥 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

ok that last one is the full combo meal and it ATE 🔥 stack those flags bestie, you got this

---

👑 AUTHORS 👑

ansilove was written by Stefan Vogt, Brian Cassidy, and Frederic Cambus. legends, honestly, we thank them for their service 💜

---

and that's the page!! shipped from Debian, dated June 10, 2026, version tag ANSILOVE(1) 💖 go convert something cute, you're gonna slay 🦋✨🎀