N64 QOI Viewer

May 1, 2026 ยท View on GitHub

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

An image viewer that loads QOI images on N64

An fuzzy image of a parrot An fuzzy image of four dice. The red die is in front. Blue, green, and yellow in the back in a triangle clockwise formation

Downloads

Go to this page to get the latest ROM: https://github.com/Aftersol/n64_qoi_dec/releases/

How to View Images on N64 QOI Viewer

The maximum supported width is 320px and the maximum supported height is 240px. This step assumes you have FFMPEG installed.

  1. Encode your image into QOI using the following commands. The ones in <> are changeable
ffmpeg -i <input file to image> -pix_fmt <rgb24 or rgba> -s <width>x<height> <output file to image>.qoi

For pixel art, the flags will scale the image using the nearest neighbor flag: -sws_flags neighbor This is useful for scaling up pixel art images

  1. Place the encoded QOI images into the filesystem folder. make will include these images in the filesystem folder into built ROM.

How to Build N64 QOI Viewer

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

Licenses

Everything in the src folder is licensed under MIT License. See LICENSE page for more info.

In the filesystem folder the following images are in the public domain:

  • zz_qrcode.qoi
  • z_smpte_color_bars.qoi
  • z_ebu_colour_bars.qoi

The rest of the images in the filesystem folder are under their respective licenses