A Library of Babel for pixel images. Every 8×8, 16×16 and 32×32 image using a fixed 16-colour palette has exactly one address, and every address decodes to exactly one image. One image, the all-white page, has no address; see How it works. There is no database and no server: an index of the image space is turned into page contents by modular multiplication, and back again by multiplying with its inverse.
The whole program is one HTML file with no dependencies. Open index.html in a
modern browser. It runs a WASM pixel codec built at runtime from opcodes inside the
file, with a pure-JS reference implementation used for base32, CRC32 and verification.
| Action | What happens |
|---|---|
| Show page | address → image (READ) |
| Find address | image → address (FIND) |
| Random page | draws a uniform random index |
| Paint / Fill / New blank page | edit pixels, then Find |
| Embed text | stores UTF-8 in the pixel bytes of a page |
| Colour preview upload | rescales any image to a page, maps to the 16 colours, optionally dithered. Lossy |
| Lossless archive upload | stores the file's bytes in one or more chained pages, CRC32-checked. Download restores the original file |
| Download exhibit PNG | indexed 4-bit PNG whose tEXt chunk carries the address |
| Download standalone exhibit | a single HTML file that decodes and renders one address |
An address is the page index in base32 (RFC4648 alphabet, no padding) followed by seven checksum characters (base32 of the CRC32 over the index bytes). Lengths are 59, 212 and 827 characters for 8×8, 16×16 and 32×32. Input is case-insensitive; spaces, dots, commas, slashes and dashes are ignored. A mistyped address either fails the checksum or decodes to the same image.
A page of w×w pixels, each an index 0–15 into the palette, is a base-16 number
V with L = w² digits. With N = 16^L − 1:
READ (address → image): value = (C · index) mod N
FIND (image → address): index = (I · value) mod N
C is the first odd integer ≥ 0x9E3779B97F4A7C15 coprime to N; I is its
modular multiplicative inverse, found with the extended Euclidean algorithm over
BigInt. Because gcd(C, N) = 1, multiplication by C permutes the residues, so
the two directions are exact inverses. This is the method used by
libraryofbabel.app, applied to pixels.
Indices run 1..N. The value V = N (every pixel the last palette entry, a pure
white page) has no index, since (I · N) mod N = 0. Exactly one image out of
16^L is unreachable; the reference implementations lose one book for the same
reason. The self-test checks this case directly.
Capacity per page is L × 4 bits: 256, 1024 and 4096 bits for 8×8, 16×16 and
32×32. A page can be read as colour indices or as raw data, so the same mechanism
that hides a text message also archives any file bit-for-bit, chained across
pages when the file is larger than one page.
Open index.html?test=1 or press Run self-tests. The suite verifies: WASM versus
JS equality for the pixel codec, CRC32 and base32 test vectors, exhaustive bijection
properties for every size, image/address round-trips, boundary pages, checksum
rejection of typos, embedded messages, exhibit PNG round-trips and lossless archive
round-trips including multi-page and corrupted sets. Payloads are random
(property-based testing); the fixed vectors and the verdict logic are deterministic.
index.html the program, the tests and the documentation
LICENSE GNU Affero General Public License v3 or later
README.md this file
- github.com/tdjsnelling/babel (GPL-3.0) — the reversible-index method this project applies to images.
- github.com/librarianofbabel/libraryofbabel.info-algo (Jonathan Basile, CC BY-NC-SA) — a different invertible map, described here for comparison. No code from that repository is reproduced in this project.
Both are cited as algorithm references. This implementation is original JavaScript, BigInt and hand-assembled WebAssembly.
Copyright (C) 2026 moon440
Pixel Babel is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See LICENSE for the full text.
Pixel Babel is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
The AGPL differs from the GPL in section 13: if you modify this program and make it available to users over a network, you must also make its source code available to those users. Any page generated by this program is just pixel data and carries no license obligation.