Skip to main content

ANSI Art Converter

GitHub Actions Workflow Status PyPI - Version

A tool to convert original ANSI art files for viewing in a modern terminal.

[!IMPORTANT] This is not an AI-generated project! I wrote this as a labor of love. I test it extensively against original artwork.


Demos

I made some videos of demo conversions that are on youtube:

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.1/ANSICombined.ttf \
  && fc-cache -f ~/Library/Fonts/ \
  && fc-list | grep "ANSICombined"

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

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

Resources

Metadata

Release files for ansi-art-convert 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ansi-art-convert 0.4.1
File Size Uploaded Provenance
ansi_art_convert-0.4.1.tar.gz 35.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ansi-art-convert 0.4.1
File Interpreter ABI Platform
ansi_art_convert-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 72.9 kB

Release files / ansi_art_convert-0.4.1.tar.gz

Download URL ansi_art_convert-0.4.1.tar.gz
Size 35.2 kB
Tags Source
SHA-256 checksum
How to use checksums
73e452761e1f6df2cfd39df165420c36acd0ed4d55bfe5377c2871339de8697b
BLAKE2b-256 checksum
How to use checksums
2e189c4265aca03688ebb54ea51c97d857616d5ac2569a6cb0cf4d94ada9b1bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / ansi_art_convert-0.4.1-py3-none-any.whl

Download URL ansi_art_convert-0.4.1-py3-none-any.whl
Size 37.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e670fb0db08a2d003ca7891668e8aa820c7096f6b5e577838d9751cecf94ae09
BLAKE2b-256 checksum
How to use checksums
f4dfb5099d771751c34d180457880bc6df59ef70cedadd4b8b2d637a18d28855
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for ansi-art-convert 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page