ansi-art-convert 0.1.1

ANSI > UTF-8 Conversion

ANSI > UTF-8 Conversion

• ANSI > UTF-8 Conversion
  • Installation
  • Usage
  • Documentation
  • Resources

---

Installation

You can install the ansi-art-convert package via pip:

pip install ansi-art-convert

[!IMPORTANT] As a prerequisite, you will need to install the ANSI megafont on your system via your regular font installer, and ensure that your terminal emulator is configured to use it.

Alternatively, you can install it via a one-liner (you will still need to configure your terminal to use it):

install commands:

# osx
curl -sOL --output-dir ~/Library/Fonts/ https://github.com/tmck-code/ansi-megafont/releases/download/v0.1.0/TopazPlusPlus.ttf \
  && fc-cache -f ~/Library/Fonts/ \
  && fc-list | grep "TopazPlusPlus"

# linux
curl -sOL --output-dir ~/.fonts/ https://github.com/tmck-code/ansi-megafont/releases/download/v0.1.0/TopazPlusPlus.ttf \
  && fc-cache -f ~/.fonts/ \
  && fc-list | grep "TopazPlusPlus"

Usage

usage: ansi-art-convert [-h] --fpath FPATH [--encoding ENCODING] [--sauce-only] [--verbose] [--ice-colours] [--font-name FONT_NAME] [--width WIDTH]

options:
  -h, --help            show this help message and exit
  --fpath, -f FPATH     Path to the ANSI file to render.
  --encoding, -e ENCODING
                        Specify the file encoding (cp437, iso-8859-1, ascii, utf-8) if the auto-detection was incorrect.
  --sauce-only, -s      Only output the SAUCE record information as JSON and exit.
  --verbose, -v         Enable verbose debug output.
  --ice-colours         Force enabling ICE colours (non-blinking background).
  --font-name FONT_NAME
                        Specify the font name to determine glyph offset (overrides SAUCE font).
  --width, -w WIDTH     Specify the output width (overrides SAUCE tinfo1).

Documentation

• SAUCE Metadata

Resources

• The origins of DEL (0x7F) and its Legacy in Amiga ASCII art
• rewtnull/amigafonts
• Screwtapello/topaz-unicode
• Rob Hagemans' Hoard of Bitfonts
• amigavision/TopazDouble