PICO-8 to TIC-80 cartridge converter

bzt 62cf6ec36d Fixed some missing operators 4 months ago
public 62cf6ec36d Fixed some missing operators 4 months ago
src 62cf6ec36d Fixed some missing operators 4 months ago
.gitlab-ci.yml 74d0e680d6 Initial commit 2 years ago
LICENSE 74d0e680d6 Initial commit 2 years ago
README.md c40ccb8c2b Support for generating .tic.png cartridges 2 years ago

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