p8totic/README.md

PICO-8 to TIC-80 cartridge converter

Online converter

This is a small tool that converts the proprietary PICO-8 fantasy console's cartridges (in both textual .p8 and binary .p8.png format) into the Free and Open Source TIC-80 console's .tic cartridge format, and tries to be feature complete while doing so. As a bonus, it can extract .tic from TIC-80 .tic.png cartridges too, and if the input is a .tic file, then outputs .tic.png.

Features

• Cover image (128 x 128 cartridge label, centered on the 240 x 136 screen)
• Sprites (all 256, saved as background sprites, aka. tiles)
• Map (the map is expanded from 128 x 64 to 240 x 136 and copied to the top left corner)
• Palette, the standard PICO-8 palette is added to the cartridge (TIC-80 supports multiple, modifiable palettes)
• Waveforms, the built-in PICO-8 waveforms are added to the cartridge
• Sound effects (partial support)
• Lua code (with syntax fixer, API replacer and an additional helper PICO-8 wrapper for TIC-80 Lua library)

TODO: sound effects and music are loaded, but not saved properly as of yet. Contributions (or just any kind of help) from someone familiar with the TIC-80 sfx (address 0x100E4) and music (address 0x11164 and 0x13E64) in-memory layout would be much appreciated!

Compilation

Just run make in the src directory, it is suckless. Only needs emscripten's emcc and gcc to compile.

• make wasm if you only want to compile the WebAssembly version (the required boilerplate html is in the public directory).
• make cli if you only want to compile the command line version (totally dependency-free, should work on any POSIX system).

License

This converter tool is licensed under the terms of MIT license, same as the TIC-80's license.

Cheers, bzt