How-tos

Short, practical guides for things you might want to do with Pixl8 that don't quite fit a one-line answer.

Looking for something quicker? The FAQ covers the common single-question stuff.

• Setting up multicart games

  Some PICO-8 games ship as multiple cart files that load each other at runtime. This guide covers how to figure out which carts you need, where to download them, and how to lay them out so Pixl8 finds every one.

  →

• Using the debugger PRO

  Walk through Pixl8's source-level debugger — how to open it from the pause menu, the dual-pane layout (with optional external display), the step / breakpoint / inspect commands, and the keyboard shortcuts that make it usable.

  →

• Recording and playing input scripts PRO

  Record button presses to a .p8.script file, replay them frame-for-frame, and edit the script by hand. Covers the recording workflow plus the full text-file syntax (presses, releases, screenshots, save/load, pause).

  →

• Backing up your data

  Three ways to take your saves, scripts and screenshots off the device — the full Backup & Restore ZIP in Settings, the per-cart save state export/import, and the per-cart screenshot export. When to reach for which, and what each one covers.

  →

• Adding Pixl8 to retro launchers

  Wire Pixl8 into Android frontends like ES-DE (Emulation Station Desktop Edition) so PICO-8 carts launch straight into Pixl8 from your existing library. The interim config recipe while native support is in the works upstream.

  →

More guides will land here over time. If there's something specific you'd like covered, open an issue on GitHub and we'll add it to the queue.