QOI Encoder Demo for N64

June 5, 2026 · View on GitHub

A text that says QOI with a beer bottle behind QOI text with N64 logo on top

https://github.com/user-attachments/assets/0d024e08-101c-45ba-83ee-db06d3b5e936

Small, QOI (Quite OK Image) encoder demo for Nintendo 64

Controls

  • A - save to QOI
  • B - save to raw
  • Z - save frame to RAM
  • DPad-Up - save to /dev/zero (null)
  • DPad-Left - View last frame
  • DPad-Down - Hide Logo
  • Start - Hide Logo

Requirements

How to Build

This tutorial assumes you have your N64 Toolchain set up including GCC for MIPS. Make sure you are on the preview branch of libdragon.

Clone this repository with --recurse-submodules or if you haven't run:


git submodule update --init

Initialize libdragon:

libdragon init

Then run make to build this project:

libdragon make

How to Run

Download the ROM in the release page and put the downloaded qoi_enc.z64 file to the SD card. Then insert the SD card with the qoi_enc.z64 into the N64 flashcart. Insert the N64 flashcart with that SD card installed into the N64 and select the qoi_enc.z64 ROM from the list of ROMs to run. Alternatively, you can build the ROM and insert that ROM into the SD card plug that into the N64 flashcart.

Tools

License

MIT License — see LICENSE file for details.