https://github.com/aftersol/n64_qoi_dec

QOI Viewer that runs on N64
https://github.com/aftersol/n64_qoi_dec

c homebrew libdragon n64 n64-dev nintendo-64 nintendo64 qoi

Last synced: about 1 month ago
JSON representation

QOI Viewer that runs on N64

• Host: GitHub
• URL: https://github.com/aftersol/n64_qoi_dec
• Owner: Aftersol
• License: mit
• Created: 2025-01-20T06:11:16.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-05-01T09:11:37.000Z (about 1 month ago)
• Last Synced: 2026-05-01T10:28:40.475Z (about 1 month ago)
• Topics: c, homebrew, libdragon, n64, n64-dev, nintendo-64, nintendo64, qoi
• Language: C
• Homepage: https://aftersol.github.io/n64_qoi_dec/
• Size: 805 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# N64 QOI Viewer

![A text that says QOI with a beer bottle behind QOI text with N64 logo on top](assets/logo/n64_qoi_logo_256px.png)

An image viewer that loads QOI images on N64

![An fuzzy image of a parrot](assets/demo_images/qoi_demo_image0.jpg)

![An fuzzy image of four dice. The red die is in front. Blue, green, and yellow in the back in a triangle clockwise formation](assets/demo_images/qoi_demo_image1.jpg)

## Downloads

[Go to this page to get the latest ROM: https://github.com/Aftersol/n64_qoi_dec/releases/](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

```bash

ffmpeg -i  -pix_fmt  -s x .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

2. 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:

```bash

git submodule update --init

```

---

Initialize libdragon:

```bash

libdragon init

```

Then run make to build this project:

```bash

libdragon make

```

---

## Licenses

Everything in the src folder is licensed under MIT License. See [LICENSE page](https://github.com/Aftersol/n64_qoi_dec/blob/main/LICENSE) 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