https://github.com/badele/splitans
Parse ANSI/ASCII file and split text and CSI Sequence
https://github.com/badele/splitans
ansi ansi-art ansi-codes ascii ascii-art bbs command-line-tool retro retrocomputing
Last synced: 16 days ago
JSON representation
Parse ANSI/ASCII file and split text and CSI Sequence
- Host: GitHub
- URL: https://github.com/badele/splitans
- Owner: badele
- License: gpl-3.0
- Created: 2025-11-29T14:33:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-05T10:52:23.000Z (20 days ago)
- Last Synced: 2026-03-05T13:58:31.343Z (20 days ago)
- Topics: ansi, ansi-art, ansi-codes, ascii, ascii-art, bbs, command-line-tool, retro, retrocomputing
- Language: Go
- Homepage:
- Size: 604 KB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Splitans is a tokenization tool that parses ANSI files and separates ANSI
sequences from text. You can save the stdout output to a file with the `.neo`
extension. The `neotex` format is simple: text content on the left, ANSI
sequences on the right, separated by `|`. The `neotex` format allows you to view
the content without requiring an ANSI terminal.
It is also possible to export to various formats, such as ANSI, table, stats or
JSON.
## Installation
```bash
export PATH="$HOME/go/bin:$PATH"
go install github.com/badele/splitans
```
## Usage
By default, `splitans` converts UTF-8 ANSI to UTF-8 `neotex` format and outputs
to stdout.
```bash
# Convert 16colors to UTF-8 ANSI (terminal)
curl -s https://16colo.rs/pack/1990/raw/WWANS157.ANS | splitans -e cp437 -F ansi
# Convert 16colors to UTF-8 ANSI with true VGA colors (disable terminal theme)
curl -s https://16colo.rs/pack/1990/raw/WWANS157.ANS | splitans -e cp437 -F ansi -V
# Convert 16colors legacy ANSI to neotex
curl -s https://16colo.rs/pack/1990/raw/WWANS157.ANS | splitans -e cp437 > /tmp/WWANS157.neo
less -S /tmp/WWANS157.neo
# Convert neotex to ANSI
splitans /tmp/WWANS157.neo -f neotex -F ansi
splitans /tmp/WWANS157.neo -f neotex -E cp437 -F ansi
# Convert 16colors to UTF-8 plaintext
splitans /tmp/WWANS157.neo -f neotex -F plaintext
cat /tmp/WWANS157.neo | colrm 80
# Copy ANSI to termbin.com
cat /tmp/WWANS157.neo | splitans -f neotex -F ansi | nc termbin.com 9999
curl -s https://termbin.com/w7sp
# Display ANSI tokens in other formats
curl -s https://16colo.rs/pack/1990/raw/WWANS157.ANS | splitans -e cp437 -F json
curl -s https://16colo.rs/pack/1990/raw/WWANS157.ANS | splitans -e cp437 -F table
curl -s https://16colo.rs/pack/1990/raw/WWANS157.ANS | splitans -e cp437 -F stats
```
## Neotex Metadata
Metadata entries live in the sequence column and start with `!` (for example
`!V1.2.0`, `!TW73/80`, `!NL42`, or SAUCE labels like `!STTitle`). Use the short
form `!KEYvalue` when the value has no separators, and the protected form
`!KEY` when it contains spaces or characters such as `;`, `,`, or `:`.
Metadata values must not contain `<` or `>`; those are rejected on import.
## Output Examples
Here are the results of the `splitans` commands, in order:
- The `neotex` format
- The 16-color ANSI format (uses the terminal theme)
- The true color ANSI format (overrides the terminal theme)
## Miscellaneous
#### Convert all ANS files to neotex
```bash
# Convert one ANSI file to neotex
just neotex-from-ansi ""
# Convert all *.ANS files to neotex
just neotex-all-delete ""
just neotex-all-from-ansi ""
```
## Sources
- Resources
- https://16colo.rs
- https://wezterm.org/escape-sequences.html#graphic-rendition-sgr
- https://vt100.net/docs/vt510-rm/chapter4.html
- https://invisible-island.net/xterm/ctlseqs/ctlseqs.html
- https://ecma-international.org/wp-content/uploads/ECMA-48_5th_edition_june_1991.pdf
- Font
- https://int10h.org/oldschool-pc-fonts/fontlist/font?toshibasat_8x14
- Logo Font
- https://n0namen0.github.io/CODEF_Ansi_Logo_Maker/ (YAZOOX)