Go to file
ZettaScript 8099e065f3 wip 2022-12-16 22:12:43 +01:00
.github/workflows Bump MSRV to 1.60, set edition to 2021 2022-10-17 00:46:02 +01:00
assets Add assets for tests and reference checks 2021-12-29 20:56:07 +03:00
bench Rename qoi-fast -> qoi (qoi-rust) + update repo 2022-01-06 03:59:32 +03:00
doc Add qoi format specification pdf to the repo 2022-01-03 14:25:40 +03:00
ext (Update the upstream qoi submodule) 2021-12-29 20:56:30 +03:00
fuzz Rename qoi-fast -> qoi (qoi-rust) + update repo 2022-01-06 03:59:32 +03:00
libqoi Add `libqoi` helper crate that wraps qoi.h 2022-01-05 17:07:30 +03:00
src wip 2022-12-16 22:12:43 +01:00
tests Make `Bytes` pub 2022-10-17 00:31:27 +01:00
.gitignore (Add fuzz coverage to .gitignore) 2022-01-03 21:57:41 +03:00
.gitmodules Add reference implementation as a submodule 2021-11-29 04:21:09 +00:00
Cargo.toml Version bump to v0.4.1 2022-10-17 00:51:38 +01:00
LICENSE-APACHE Add license files 2022-01-03 14:25:40 +03:00
LICENSE-MIT Add license files 2022-01-03 14:25:40 +03:00
README.md wip 2022-12-16 22:12:43 +01:00
rustfmt.toml Initial working version (but lots of temp stuff) 2021-11-28 16:20:24 +00:00



Build Latest Version Documentation Apache 2.0 MIT unsafe forbidden

Fast encoder/decoder for QOI image format, implemented in pure and safe Rust.

  • One of the fastest QOI encoders/decoders out there.
  • Compliant with the latest QOI format specification.
  • Zero unsafe code.
  • Supports decoding from / encoding to std::io streams directly.
  • no_std support.
  • Roundtrip-tested vs the reference C implementation; fuzz-tested.

Note about this fork

This fork implements a slight improvement to the original specs, which leaves unused the QOI_OP_RGBA chunk flag with RGB.

Here, we use this flag for the new QOI_OP_RUN2 chunk. It's like the QOI_OP_RUN chunk, but followed by two bytes representing run (BE). (only for RGB, as the flag is already used for RGBA)

The decoder remains fully compatible with the original one (except when using QOI_OP_RGBA in a RGB image). The encoder is fully compatible for RGBA, not for RGB (except using the reference feature).

Why this? Because it enables significant improvements for compressing images with large uniform areas (such as screen captures), or for encoding a diff-filtered video stream where successive frames often have identical regions. (see syeve for the video encoding)


use qoi::{encode_to_vec, decode_to_vec};

let encoded = encode_to_vec(&pixels, width, height)?;
let (header, decoded) = decode_to_vec(&encoded)?;

assert_eq!(header.width, width);
assert_eq!(header.height, height);
assert_eq!(decoded, pixels);


             decode:Mp/s  encode:Mp/s  decode:MB/s  encode:MB/s
qoi.h              282.9        225.3        978.3        778.9
qoi-rust           427.4        290.0       1477.7       1002.9
  • Reference C implementation: phoboslab/qoi@00e34217.
  • Benchmark timings were collected on an Apple M1 laptop.
  • 2846 images from the suite provided upstream (tarball): all pngs except two with broken checksums.
  • 1.32 GPixels in total with 4.46 GB of raw pixel data.

Benchmarks have also been run for all of the other Rust implementations of QOI for comparison purposes and, at the time of writing this document, this library proved to be the fastest one by a noticeable margin.

Rust version

The minimum required Rust version for the latest crate version is 1.61.0.


This crate supports no_std mode. By default, std is enabled via the std feature. You can deactivate the default-features to target core instead. In that case anything related to std::io, std::error::Error and heap allocations is disabled. There is an additional alloc feature that can be activated to bring back the support for heap allocations.


This project is dual-licensed under MIT and Apache 2.0.