libansilove

libansilove is a library to convert ANSi and artscene related file formats into PNG images.

Dependencies

libansilove uses the CMake build system and requires the GD library and header files.

Installing dependencies

• OpenBSD: pkg_add -r cmake gd
• NetBSD: pkgin install cmake gd
• FreeBSD: pkg install cmake gd
• macOS: brew install cmake gd
• Alpine Linux: apk add cmake gcc make musl-dev gd-dev
• Debian / Ubuntu / Mint: apt-get install build-essential cmake libgd-dev
• Fedora: dnf install cmake gcc make gd-devel
• Solus: eopkg install -c system.devel and eopkg install gd-devel

Compiling

mkdir build
cd build
cmake ..
make

Installation

make install

Packages

libansilove packages are available for:

• OpenBSD
• NetBSD
• FreeBSD
• Debian
• Ubuntu
• openSUSE
• Solus
• Gentoo
• Homebrew
• Guix

Features

The following formats are supported:

• .ANS - ANSi (ANSI escape sequences: ANSI X3.64 standard)
• .PCB - PCBoard Bulletin Board System (BBS) own file format
• .BIN - Binary format (raw memory copy of text mode video memory)
• .ADF - Artworx format, supporting custom character sets and palettes
• .IDF - iCE Draw format, supporting custom character sets and palettes
• .TND - TundraDraw format, supporting 24-bit color mode
• .XB - The eXtended Binary XBin format, supporting custom character sets and palettes

Documentation

Usage

See the example directory for an example showing how to use the library to convert a file to PNG.

Projects using libansilove

• Ansilove - ASCII / ANSI art to PNG converter, also supporting several artscene file formats
• ANSi View (PS3) - ANSi and artscene related file formats viewer for the PlayStation 3

Bindings

Bindings for other programming languages:

• Racket

License

libansilove is released under the BSD 2-Clause license. See the file LICENSE for details.

Authors

libansilove is developed by Stefan Vogt (@ByteProject), Brian Cassidy (@bricas) and Frederic Cambus (@fcambus).

Resources

Project homepage: https://www.ansilove.org

GitHub: https://github.com/ansilove/libansilove