CP437 tools

A small collection of tools to handle CP437 files.

Commands

cp437-read-meta

Prints the metadata of a file to stdout. Useful for finding issues, since it will highlight potential problems, marking assumptions or default values with yellow, problems in red, and successes in green. Inconsequential fields are just shown in the default foreground colour.

cp437-to-txt

Simply strips metadata and maps CP437 to UTF-8. Takes an optional argument to the output file, but defaults to showing the result in the terminal.

cp437-to-png

Renders the CP437 as a PNG image. Takes an optional argument to the output file, but if not given it allows piping to other programs such as imagemagick.

lib

While not intended for use as a library, it may still prove useful. Be warned though that no guarantees are made about the stability of the API.

Development

The repo comes with a nix flake, so simply type nix develop and you'll have a bash terminal with all tools needed for building this codebase.

You have an example file for simple tests (the same used for the screenshots above), but if you need more:

$ nix build '.#test_files'
$ ls ./result/
comments.ans  large.ans  meta.ans  simple.ans

Licenses

This project's code is made freely available under the GPLv3+ license. The fonts used are provided by int10h.org under the CC-BY-SA-4.0 license.