ansiwave
ANSI art + MIDI music
Summary
| Latest Version | 1.8.0 |
|---|---|
| License | Public Domain |
| CI Status | Failing |
| Downloads | 0 |
| Last Indexed | 2026-09-01 07:19 |
Tags
Authors
- oakes
Installation
nimble install ansiwave
choosenim install ansiwave
git clone https://github.com/ansiwave/ansiwave
OS Compatibility
| Platform | Linux | macOS | Windows | FreeBSD | OpenBSD | NetBSD | Android | iOS | WASM | Embedded |
|---|---|---|---|---|---|---|---|---|---|---|
| ansiwave | ✓ | ✓ | ✓ | - | - | - | - | - | - | - |
Dependencies
| Package | Version | Optional |
|---|---|---|
| nim >= | 1.4.2 | No |
| pararules >= | 1.4.0 | No |
| paramidi >= | 0.6.0 | No |
| paramidi_soundfonts >= | 0.2.0 | No |
| parasound >= | 1.0.0 | No |
| zippy >= | 0.10.5 | No |
| stb_image >= | 2.5 | No |
| wavecore >= | 0.9.0 | No |
| chrono >= | 0.3.1 | No |
| nimwave >= | 1.2.1 | No |
Source
| Repository | https://github.com/ansiwave/ansiwave |
|---|---|
| Homepage | https://github.com/ansiwave/ansiwave |
| Registry Source | nimble_official |
README
The haters told me BBSes, ANSI art and MIDI music were dead so I combined them together.
<-- click meANSIWAVE BBS is a bulletin board where you can have threaded discussions and share ANSI art and MIDI music. It is the glorious mashup that nobody asked for and everybody needs.
- Download the terminal client for windows, macos, or linux
- Enter the web portal
- Watch the screencast
How to fire this puppy up and get 'er done
Either download a prebuilt binary, or you can build from source: install Nim and then do nimble install in this directory (make sure ~/.nimble/bin is on your PATH).
To access the BBS, just run it without any arguments:
ansiwave
If you have a specific post you want to go to, you can just give the URL as the argument:
ansiwave https://bbs.ansiwave.net/bbs/#...
To view the BBS offline, clone it with git and point the terminal client to it:
git clone https://git.ansiwave.net/git/boards/kEKgeSd3-74Uy0bfOOJ9mj0qW3KpMpXBGrrQdUv190E/board
cd board
ansiwave .
You can also use ANSIWAVE as an offline tool; no need to share your creations on the BBS. You can open a new or existing file like this:
ansiwave hello.ansiwave
On the web portal of the BBS, there is a "plain view" button which takes you to a pure HTML version of the post. Its URL is very long because it contains the entire content inside of it. You can then open it in the terminal client like this:
ansiwave https://bbs.ansiwave.net/bbs/view.html#...
And you can save it to a file like this:
ansiwave https://bbs.ansiwave.net/bbs/view.html#... hello.ansiwave
There are a couple other cool things you can do. If you have a .ansiwave file, you can synthesize the music in it to a wav file:
ansiwave hello.ansiwave hello.wav
And if you have any old-school ANSI art encoded in CP437, you can convert it into an ansiwave:
ansiwave hello.ans hello.ansiwave --width=80
Oh, and if you just want to look at an ansiwave, there is already an ansiwave viewer built into every 'nix machine on the planet:
cat hello.ansiwave
It's just unicode, homies!