kylxbn/pixel-exchange-format
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Encode audio or arbitrary binary data into fixed-width images
5 commits 1 branch 0 tags 35 MiB
Find a file
Exact
Kyle Alexander Buan 86ed3ce3e9
 add website
2026-03-15 21:24:34 +08:00
.github/workflows first commit 2026-02-23 23:06:07 +08:00
app Try to fix Japanese i18n not working 2026-02-24 13:44:56 +08:00
cli first commit 2026-02-23 23:06:07 +08:00
codec first commit 2026-02-23 23:06:07 +08:00
doc first commit 2026-02-23 23:06:07 +08:00
jpeg-decoder first commit 2026-02-23 23:06:07 +08:00
third-party first commit 2026-02-23 23:06:07 +08:00
web add website 2026-03-15 21:24:34 +08:00
LICENSE first commit 2026-02-23 23:06:07 +08:00
README.md Add web UI link 2026-02-23 23:31:32 +08:00

README.md

Pixel Exchange Format

I don't know how this codec even reached version 3.0.0. What the heck.

Try it here.

Format Overview

The Pixel Exchange Format (PXF) v300 encodes audio or arbitrary binary data into fixed-width images. It combines deterministic transforms, forward error correction, and integrity checks so data can be reconstructed after common image degradation.

Encoding Modes

encode

PXF supports encoding arbitrary binary data, with a dedicated audio mode for better compression.

Audio Mode

audio_mode

Stereo is represented as mid/side image pairs, not left/right image channels.

Binary Mode

binary_mode

Binary mode stores 2480 bytes per data row. Payload symbols are mapped into YCbCr/RGB blocks (2-bit Y + 1-bit Cb + 1-bit Cr), then protected with row LDPC parity and CRC32C.

Decoding Capabilities

Decoding supports:

  • Full reconstruction from complete images
  • Streaming/progressive audio decode
  • Multi-image reassembly using header random bytes + image indices
  • Source grouping by shared 4-byte random header salt

A dedicated UI is used when decoding audio mode, binary mode containing audio, and binary mode containing MIDI.

decode_audio

decode_file

decode_midi

Contents

This repo contains various software needed to use the codec:

  • The actual codec itself in codec/
  • A Web UI in order to encode / decode files in app/
  • A CLI to encode / decode files in the ternimal in cli/
  • A custom JPEG decoder used by the Web UI and CLI in jpeg-decoder/

License

BSD 3-Clause License (BSD-3-Clause). See LICENSE.

Unless otherwise noted, all source code in this repository is licensed under the BSD 3-Clause License.