Docs / Specifications, source material and credits

Specifications, source material and credits#

Three things live on this page: the hardware references the emulator follows, subsystem by subsystem; the file formats it reads and writes; and the credits. VICE (x64sc) is also the runtime cross-check oracle; the diff workflow is documented in Testing.

With gratitude to the VICE team. The following was important to the success of this project:

• VICE: the gold-standard C64 emulator, used as the runtime comparison oracle. https://vice-emu.sourceforge.io/
• VICE test progs: cycle-exact hardware test suite. https://github.com/libsidplayfp/VICE-testprogs

General C64 references#

• Commodore 64 Programmer's Reference Guide (Commodore, 1982): the register-level description of sprites (§3.5) and the $01 port / banking (§3.3) several spec tests are written against.
• Mapping the Commodore 64: Sheldon Leemon (Compute!, 1984); the memory map the PLA tests check a few entries of.

References by subsystem#

VIC-II video (6567/6569/8565)#

• Bauer, The MOS 6567/6569 video controller (VIC-II) and its application in the Commodore 64: the primary reference. https://www.cebix.net/VIC-Article.txt
• VICE addendum: VIC-II Addendum: Key Technical Differences from Bauer's Article (Kahlin / Nuotio / Lankila / Matthies, rev 0.3, 20100729): supplements Bauer where it was incomplete or wrong. https://sourceforge.net/p/vice-emu/code/HEAD/tree/techdocs/VICII/VIC-Addendum.txt
• "Nine" by Linus Åkesson (lft): the author's explanation page is used directly as a spec for several VIC-II tricks. Thank you, Linus, for all your brilliant demos and inspiration. https://www.linusakesson.net/scene/nine/explanation.php
• Pepto / Colodore palettes: Philip "Pepto" Timmermann's measured PAL palette (2001) and his Colodore successor. Both ship as the emulator's selectable color palettes (PALETTES in src/vic2-tables.js); Colodore is the default. https://www.pepto.de/projects/colorvic/ · https://www.colodore.com
• Bumbershoot Software: VIC-II/CPU interaction timing articles ("VIC-II interrupt timing"; VIC-before-CPU same-cycle ordering, BA lead time), corroborating Bauer §3.6.1/§3.8.1. https://bumbershootsoft.wordpress.com/2015/07/26/vic-ii-interrupt-timing-or-how-i-learned-to-stop-worrying-and-love-unstable-rasters/

6510 / 6502 CPU#

• MOS 6502 datasheet: cycle counts and microarchitecture (the MOS 6500-family MPU datasheet). https://6502.org/documents/datasheets/mos/mos_6500_mpu_preliminary_may_1976.pdf
• Klaus Dormann's 6502 functional test: exhaustive opcode/flag verification. https://github.com/Klaus2m5/6502_65C02_functional_tests
• groepaz, NMOS 6510 Unintended Opcodes: ground truth for the illegal opcodes: the SH* family's address-high instability and JAM/KIL behavior (as also presented in Michael Steil's c64ref). https://www.pagetable.com/c64ref/6502/
• 64doc: John West & Marko Mäkelä's cycle-by-cycle 65xx reference; cited for illegal-opcode semantics (ARR's decimal-mode interaction). https://www.atarihq.com/danb/files/64doc.txt
• Visual6502: transistor-level 6502 simulation, cross-checked for the same illegal-opcode edge semantics. http://www.visual6502.org
• NESdev wiki, CPU interrupts: the 6502 core's interrupt polling, the /NMI edge detector, interrupt hijacking and the no-poll rule for the interrupt sequences themselves (Visual6502-derived; the 6510 shares the core). https://www.nesdev.org/wiki/CPU_interrupts
• Bruce Clark, Decimal Mode: the definitive tutorial on 6502 BCD arithmetic; the ADC/SBC decimal-mode algorithm follows his analysis. http://www.6502.org/tutorials/decimal_mode.html
• Adam Vardy, Extra Instructions Of The 65XX Series CPU (1996): the illegal-opcode cycle-count table the opcode audit test compares against. http://www.ffd2.com/fridge/docs/6502-NMOS.extra.opcodes

CIA / 6526#

• MOS 6526 (CIA) datasheet: timers, TOD, serial-register behavior, and the PC and FLAG handshake lines the user port brings out (the CIA spec tests cite the re-typeset archive.org copy by sheet number). https://6502.org/documents/datasheets/mos/mos_6526_cia_preliminary_nov_1981.pdf · https://archive.org/details/mos_6526_cia_recreated
• Wolfgang Lorenz, A Software Model of the CIA6526: reverse-engineered cycle timing and the PB6/PB7 timer outputs, plus the CIA compatibility test suite this project validates against. https://ist.uwaterloo.ca/~schepers/MJK/cia6526.html

SID 6581 / 8580 audio#

• HVSC SID file format: version-gated second-chip addresses and model flags, including the invalid-address rule and unknown-model inheritance. https://www.hvsc.c64.org/download/C64Music/DOCUMENTS/SID_file_format.txt

• MOS Technology 6581 Sound Interface Device: original SID data sheet covering the register map, oscillator, envelope, filter, and external interface. https://6502.org/documents/datasheets/mos/mos_6581_sid.pdf

• Bob Yannes: the original SID designer's design rationale for the envelope model, its small ADSR-rate lookup table, and the 23-bit pseudo-random noise generator, from Andreas Varga's 1996 interview. The exact rate periods and noise-output taps used here come from reSID / resid-test. https://trondal.com/c64sid/yannes.html

• reSID by Dag Lem: the SID engine is substantially a JavaScript translation of reSID (GPL-2.0-or-later, conveyed within this GPL-3.0-or-later project). https://github.com/daglem/reSID

  • What is ported: oscillator/waveform/noise timing, the pipelined ADSR envelope, the measured combined-waveform tables (OSC3 samplings of real chips, embedded verbatim), the R-2R DAC models with subthreshold leakage, the transistor-level filter / mixer / nonlinear volume stage (filter8580new), the C64 external RC filter, and the Kaiser-sinc audio resampler.
  • The WASM engine is the same model twice removed: a Rust translation of this project's JavaScript (rust/sid/, the corresponding source), compiled to WebAssembly and embedded; its output is bit-identical to the JavaScript engine by test.

• VICE (The VICE Team): the port is pinned to reSID as distributed in VICE 3.10's modified src/resid tree. https://vice-emu.sourceforge.io/

  • Why VICE's tree: headless VICE x64sc is this project's byte-level regression oracle, and some ported behaviors exist only there (the measured gradual TEST-bit fade of the noise shift register; the improved 8580 filter model VICE's default build compiles). The runtime parameter conventions of VICE's reSID wrapper (filter bias, resampler passband/gain, output amplification) are followed for oracle parity.
  • Where the pin is recorded: the exact upstream (official VICE 3.10 source release, tarball sha256) is in NOTICE.txt.

• Combined-waveform sample lineage: the embedded wave tables descend from OSC3 samplings of 6581 R1/R3/R4 and 8580 R5 chips provided to reSID by Tibor Biczo, Andreas Boose, and André Fachat (reSID THANKS).

• reSIDfp / Antti Lankila: 6581 filter/distortion research and SID measurement lineage preserved through reSID citations. No reSIDfp source is ported; the filter stage comes from reSID's filter8580new model. https://github.com/libsidplayfp/libsidplayfp

Memory / PLA / banking#

• "The C64 PLA Dissected" by Thomas 'skoe' Giesel: 82S100 PLA behaviour; the ground truth for the banking / $01-port / Ultimax mapping logic in memory.js. Table A.11 also defines the VIC-II's Ultimax view used by vic2.js: cartridge ROMH at local $3000-$3FFF, with DRAM rather than character ROM in the remaining VIC windows. https://www.skoe.de/docs/c64-dissected/pla/c64_pla_dissected_a4ds.pdf

ROM images#

The C64 and 1541 ROMs aren't bundled (they're copyrighted); you supply them once. The emulator was developed and tested against these specific CBM ROM revisions:

• KERNAL: kernal.901227-03.bin (8 KB)
• BASIC: basic.901226-01.bin (8 KB)
• CHARGEN: characters.901225-01.bin (4 KB)
• 1541 DOS: 1541-II.251968-03.bin (16 KB, optional, for True Drive Emulation)

Cartridges#

• CRT cartridge image format: from the CCS64 emulator (Per Håkan Sundell); the 64-byte header + CHIP packets that src/media/crt.js parses. https://ist.uwaterloo.ca/~schepers/formats/CRT.TXT
• Final Cartridge III hardware: ReplayResources register description plus Thomas Giesel's hardware-derived errata define the four 16 KB banks, permanent IO1/IO2 ROM mirror, $DFFF EXROM/GAME/NMI/hidden-register latch, and physical RESET/FREEZE behavior used by the type-3 mapper. https://rr.c64.org/wiki/Final_Cartridge https://rr.c64.org/wiki/Final_Cartridge_III_Internals_Errata.txt
• Action Replay v4.x/v5/v6 hardware: the MK5/6 schematic and hardware-derived AR6 PLA dump define its 32 KB ROM, 8 KB RAM, mirrored $DE00 latch, IO2 window, cartridge-kill and latched freezer behavior. In particular, the schematic's missing R/W qualification on IO1 is why a read clocks the current phi1 bus byte into the latch. https://rr.c64.org/wiki/File:Action_Replay_MK5_6.gif https://rr.c64.org/wiki/File:Ar6pla.rar
• EasyFlash hardware: Skoe's EasyFlash Programmer's Reference defines the bank/control registers, EXROM/GAME truth table, and IO2 RAM. https://skoe.de/easyflash/files/devdocs/EasyFlash-ProgRef.pdf
• Magic Desk-compatible hardware: the Universal Cartridge hardware description documents the $DE00 bank latch, 8 KB ROML mapping, and bit-7 cartridge disable used by this model. Its expanded hardware offers seven bank bits; the emulator implements a six-bit, 64-bank subset. https://github.com/msolajic/c64-uni-cart

RAM Expansion Unit (1700 / 1764 / 1750)#

• Wolfgang Moser, Technical Reference of the REU controller CSG8726R1 (rev 1.0, 2008): the authoritative description of the controller: the register file, transfer types, autoload and $FF00 trigger, and the end-of-transfer register state. https://zimmers.net/anonftp/pub/cbm/documents/chipdata/CSG8726TechRefDoc-1.0.zip
• Commodore 1700/1750 RAM Expansion Module User's Guide: unit capacities, the status size bit, and the DMA rates: 1 MB/s for STASH and FETCH against 500 KB/s for SWAP, the processor halted throughout, VIC DMA taking precedence. https://www.zimmers.net/anonftp/pub/cbm/manuals/cmd/1750-CLONE-users-guide.txt

User port and Hayes Modem#

• Commodore Modem/1200 (1670) User's Manual, Technical Information, pages 61 and 62: 2225 Hz answer tone and Bell 212A 1200/2400 Hz carriers used by the shortened speaker effect. https://www.pagetable.com/docs/cbm1670modem/cbm1670modem_manual.pdf

• Cisco, Feature Tones: North American ringing and network reorder frequencies and cadences. These effects do not simulate an analogue telephone connection. https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/bts/6-0-4/maintenance/guide/OMr604/AppA.html

• Commodore 64 Programmer's Reference Guide: the RS-232 control register baud codes.

• Michael Steil, UP9600: How to Bit-Bang 9600 Baud RS-232 on the C64: the user port RS-232 lines. https://www.pagetable.com/?p=1656

• Put your C64 online for ten bucks (Compute's Gazette, 2026): WiFi modem wiring. https://www.computesgazette.com/2026/07/28/put-your-c64-online-for-ten-bucks/

• CCGMS Terminal, UP9600 driver (after Daniel Dallmann's UP9600): the UP9600 bridges and how its driver uses the CIA shift registers. https://github.com/mist64/ccgmsterm

• Bo Zimmerman, Zimodem: the modem command set. https://github.com/bozimmerman/Zimodem

• Hayes command set: Wikipedia and the Wikibooks Serial Programming pages. https://en.wikipedia.org/wiki/Hayes_AT_command_set · https://en.wikibooks.org/wiki/Serial_Programming/Modems_and_AT_Commands

• RFC 854, 855, 857, 858 (Telnet) and RFC 6455 (WebSocket). https://www.rfc-editor.org/

• Rick Parrish, fTelnet: the relay URL convention. https://www.ftelnet.ca/

Pluggable IEC devices and printer#

Plugin install review uses the MIT-licensed Acorn JavaScript parser to read constant metadata without executing the file. Executable device code loads only after acceptance. See Build device plugins.

• Michael Steil, Commodore Peripheral Bus: Standard Serial: physical open-collector lines, bit transfer, ATN command reception and timing-based EOI. The listener helper recognizes a 200 microsecond ready-to-start delay and acknowledges EOI for at least 60 microseconds. Byte bits arrive least significant first on released CLK, and reception is acknowledged on DATA. ATN acknowledgement holds DATA low through the talker's initial CLK fall, before the normal byte-ready handshake begins. https://www.pagetable.com/201
• Michael Steil, Commodore Peripheral Bus: Part 2, Bus Arbitration, TALK/LISTEN: LISTEN addresses, UNLISTEN and secondary-address command groups. Every connected device participates in ATN reception, only selected listeners receive data. https://www.pagetable.com/173
• Commodore MPS-801 User Manual, sections 5.3 to 5.6: common graphics commands. Code 8 selects bit images, with bit 7 set and bit 0 at the top. Code 16 takes two decimal position digits, ESC 16 takes high then low bytes. https://www.manualslib.com/manual/843571/Commodore-Mps-801.html
• Commodore MPS-803 Service Manual, June 1987, PN 314003-05, printed pages 1-2 and 1-5 to 1-8: the renderer uses its 1/60 inch horizontal and 1/72 inch vertical dot pitch, 1/6 inch text feed and 7/72 inch graphics feed. SUB 26 repeats a graphics column, with count zero meaning 256. Dot positions are nine-bit, high byte first. Secondary address 7 selects business mode. https://retro-bobbel.de/zimmers/cbm/schematics/printers/MPS-803_Service_Manual_314003-05_%281987_Jun%29.pdf
• Browser HTML printing, window.print(), afterprint and CSS paged media: IEC Printer builds SVG Letter pages in a hidden document and invokes the browser print dialog directly, with no separate preview tab. The browser handles printer selection and PDF saving. The hidden document is removed after printing or cancelling. https://html.spec.whatwg.org/multipage/timers-and-user-prompts.html#printing https://www.w3.org/TR/css-page-3/

IEC Printer uses a fixed 512 KB raw spool. A full spool withholds acknowledgement, and Clear job resumes reception of the held byte. Rendering is limited to 100 Letter pages per print action. Parsing, DOM work and browser storage stay out of byte callbacks. Text uses a browser monospace font with approximate character mapping. No printer firmware or driver code is ported. Letter paper, form feeds and job limits are browser output choices. Headless CLI export uses the same MPS decoding and limits. SVG stacks Letter pages in one image, HTML uses separate print pages. No PDF library or additional printer firmware is ported.

Additional devices expose physical ATN/CLK/DATA levels and one emulated-time timer per instance. ATN belongs to the C64, plugins only pull or release CLK and DATA. Addresses 4 to 30 are available, except 8 and 9, which remain the existing drive slots. No drive ROM is required for IEC plugins. The bus folds all participants into wired-AND levels, preserving the existing drive-to-C64 visibility pipeline. Each plugin instance is isolated by address in settings and snapshots. Snapshots contain device data, never executable plugin source.

1541 disk drive#

• D64 disk-image format: Peter Schepers, D64 (Electronic form of a physical 1541 disk). src/media/d64.js follows it for image sizes, BAM layout and directory entries, reading and writing alike (writeSector, createBlankD64, writePRG), for the per-sector error table src/gcr.js turns back into read failures, and for the 40-track BAM extension locations. https://ist.uwaterloo.ca/~schepers/formats/D64.TXT
• D71 disk-image format: Peter Schepers, “The D71 disk image format”, VICE manual §17.7, edited by Marco van den Heuvel. Geometry, split second-side BAM, metadata tracks and optional error table: https://vice-emu.sourceforge.io/vice_17.html#SEC424
• D81 disk-image format: Peter Schepers, D81 (Electronic form of a physical 1581 disk). src/media/d64.js follows it for the image sizes, the header at 40/0, the BAM at 40/1 and 40/2 and the directory from 40/3, reading and writing alike; the 3160 free blocks of a formatted disk are the 1581 User's Guide's figure. https://ist.uwaterloo.ca/~schepers/formats/D81.TXT
• Virtual drive (TDE off): the KERNAL's serial routines, their ROM entry points and the status bits, from the Commodore 64 Programmer's Reference Guide and Mapping the Commodore 64; the DOS side (open syntax, commands, error numbers and messages, the status line) from the 1541 User's Guide and the 1581 User's Guide. src/media/virtual-drive.js approximates M-R, M-W, M-E and a full disk.
• G64 disk-image format: Peter Schepers, G64 (GCR-encoded 1541 disk image), and the VICE manual's description of the same layout. src/media/g64.js follows them for the header, the half-track offset and speed-zone tables, per-track lengths and the per-byte speed maps; the sector view decodes each whole track with the read-head rules of src/gcr.js, ignoring the two off bytes after a data block's checksum as the DOS does. https://ist.uwaterloo.ca/~schepers/formats/G64.TXT https://vice-emu.sourceforge.io/vice_17.html
• NIB and NBZ nibbler dumps: nibtools by Markus Brenner, Pete Rittwage and contributors defines both (.nib: an 8 KB raw 1541 read per half-track; .nbz: the same as one LZ77 stream), and its nibconv sets the conversion rules that src/media/nib.js ports. The LZ77 stream is Marcus Geelnard's Basic Compression Library format (lz.c in nibtools). Credits: NOTICE.txt. https://github.com/rittwage/nibtools
• 1541 read circuit: VICE's drive/rotation.c for the transition-reset bit clock and the weak-bit timing (random transitions from 18 µs after the last real one, then every 2-25 µs) that src/drive1541.js (_readCell) follows. Credits: NOTICE.txt. https://github.com/VICE-Team/svn-mirror/blob/main/vice/src/drive/rotation.c
• KERNAL load-message entry points: the TDE-off load trap calls the ROM's own SEARCHING FOR ($F5AF) and LOADING ($F5D2) routines instead of imitating them. Both addresses were identified from the shipped 901227-03 image, not quoted from a disassembly; machine.js re-checks their opening bytes at run time and loads silently on a ROM that doesn't match.
• Inside Commodore DOS by Immers & Neufeld (Abacus): background reference for CBM DOS internals and the disk format. (The byte-ready and PA-latch specifics are cited to Die Floppy and the schematics below.) https://archive.org/details/Inside_Commodore_Dos
• 1541 DOS ROM disassembly: Michael Steil's buildable, annotated source for the 251968-01/-02/-03 revisions; ground truth for the true-drive CPU timing. https://github.com/mist64/dos1541
• Sparkle: trackmo loader by Sparta / OMG; its source and Aloft's install stream informed validation of the drive's byte-ready/SO timing and IEC inter-block handshake. https://github.com/spartaomg/Sparkle
• Spindle: trackmo loader by lft / Linus Åkesson; a compatibility target whose command-stream cadence shaped the IEC idle-skip hysteresis. https://www.linusakesson.net/software/spindle/v2.php
• Krill's Loader: IRQ loader by Krill / Plush; its 2-bit IEC transfer protocol is a compatibility target the bus-coupling tests guard. https://csdb.dk/release/?id=226124
• MOS 6522 (VIA) datasheet: timers, ports, and handshake lines; the drive's two VIA chips (src/6522.js) follow it. https://6502.org/documents/datasheets/mos/mos_6522_preliminary_nov_1977.pdf
• Die Floppy 1541 / Die Floppy 1570/1571: Karsten Schramm (Markt & Technik); the GCR/sector framing and mechanics chapters of the 1541 book (the drive tests map them), and the VIA2 CA2/SOE gating and byte-ready wiring details of the 1570/1571 book (§8.2).
• 1541 schematics / service manual: the SYNC 10-bit shift register, the byte-ready PA latch, the per-zone cycle counts, the read/write head select (VIA2 CB2), and the write-protect sense line (VIA2 PB4, active low: 0 = protected, 1 = write enabled). These govern the write path's mode select and write-protect polarity; the latter is cross-checked against the real DOS ROM, which raises error 26 ("WRITE PROTECT ON") when PB4 reads low. https://www.zimmers.net/anonftp/pub/cbm/schematics/drives/new/1541/

Datasette (1530 / C2N) and tape formats#

• Analyzing C64 tape loaders: the SAVE-side convention src/datasette.js records by: a pulse is the distance between consecutive low→high transitions of the cassette write line. Also the polled-$DC0D idiom of turbo loaders. https://github.com/binaryfields/zinc64/blob/master/doc/Analyzing%20C64%20tape%20loaders.txt

• Peter Schepers: TAP (Raw tape image): the container's header, the v0/v1 $00 escapes, and the reference clocks. Also the encoding src/media/tap-audio.js renders to audio and src/media/wav-tape.js writes back out. https://ist.uwaterloo.ca/~schepers/formats/TAP.TXT

• Markus Brenner: the TAP v2 half-wave extension, "starting with a 0→1 transition", which fixes the edge a recorded pulse is measured from, and which src/media/tap-audio.js reproduces as a level toggle per pulse. https://vice-emu.sourceforge.io/vice_17.html

• Luigi Di Fraia: the DC2N DMP dump format: header, tick samples, the overflow rule and the v1 half-wave flag, which src/media/dmp-tape.js reads. https://www.luigidifraia.com/technical-info/

• RIFF / WAVE (Microsoft & IBM, Multimedia Programming Interface and Data Specifications 1.0): the container src/media/wav-tape.js reads and src/media/tap-audio.js writes, including WAVE_FORMAT_EXTENSIBLE. https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/Docs/riffmci.pdf

• Peter Schepers: T64 (Tape image / archive): the 64-byte header and 32-byte directory entries cli/t64.mjs reads and writes; the used-entries count and end addresses are not trusted, and memory snapshots are skipped. https://ist.uwaterloo.ca/~schepers/formats/T64.TXT

• Michael Steil (pagetable.com): A Minimal C64 Datasette Program Loader: the pulse trio in TAP units with the $39/$4E read thresholds, byte frame and countdown, which test/tape/kernal-tape-save-test.js decodes a recording against. https://www.pagetable.com/?p=964

• Turbo Tape 64 (Stephan Senz, 64'er / Markt & Technik, 1983): the format src/media/tap-turbo-formats.js reads: the 211/324 µs pulse pair, $02 lead-in and $09…$01 countdown as laid out in the Lemon64 thread The turbo speed tape format explained?; the block checksum and the clones' timings are this project's own measurements of tapes written by nineteen Turbo Tape 64 savers. https://www.lemon64.com/forum/viewtopic.php?t=84032

• KERNAL saver Timer B timings: measured against the real 901227-03 ROM, not quoted; published tables disagree in the low bits.

Eight of the turbo formats have no published source to cite. GRL-Supertape (Geir Rune Ladehaug, 1986) was measured off tapes it wrote; Novaload, US Gold / Datasoft, Gremlin Type 2, Ocean / Imagine, Freeload, Wildload and PROCASS (US Gold's own mastering system) were each read out of the loader its own tapes carry, by disassembling it. What they turned out to be is in the Datasette architecture notes.

Assembly64 catalog#

• Assembly64 supplies catalog search and downloadable files for demos, intros, music, graphics, diskmags and other C64 productions.
• Assembly64 OpenAPI contract defines the search, preset, category, detail, file-list and download endpoints. The charts come from charts/{demos|onefiledemos|games|music|graphics|tools} on the same server, which the contract does not list: a ranked array of id, category, name and siteRating.
• Ultimate's Assembly64 client is a protocol and AQL syntax reference.

Achievements and leaderboards#

• rcheevos (RetroAchievements, MIT): the achievement runtime, compiled to WebAssembly and run in the app. Its condition strings define every achievement and leaderboard, and its hash identifies a game: for the C64, the MD5 of the whole file. https://github.com/RetroAchievements/rcheevos
• WASI and wasi-libc: the system interface and C library the module is built against with LLVM's clang. The app supplies the few WASI calls the module imports. https://github.com/WebAssembly/wasi-libc

Accounts and passkeys#

• W3C: Web Authentication, Level 3: the registration (§7.1) and authentication (§7.2) checks the server makes, including the signature counter's clone guard. https://www.w3.org/TR/webauthn-3/
• RFC 8949: Concise Binary Object Representation (CBOR), the encoding of a passkey's attestation and public key. https://www.rfc-editor.org/rfc/rfc8949
• RFC 9053: CBOR Object Signing and Encryption (COSE), the key types ES256, EdDSA and RS256 a passkey may use. https://www.rfc-editor.org/rfc/rfc9053
• Crockford's Base32: the alphabet of the recovery codes, which reads back without confusing 0 and O, or 1, I and L. https://www.crockford.com/base32.html

Capture formats#

• ISO base media / MP4 file format: ISO/IEC 14496-12 and 14496-14 define the fragmented-MP4 structure src/mp4-remux.js walks and the progressive, indexed file it rebuilds so editors will trim it. The remux does no codec work; the codec configuration is copied through byte for byte.
• W3C: Portable Network Graphics (PNG) Specification, Third Edition (ISO/IEC 15948): the chunks, CRC-32 and deflated scanlines cli/png.mjs writes with only zlib, and the APNG chunks (acTL, fcTL, fdAT) that film a run as changed rectangles. https://www.w3.org/TR/png/

Credits#

Thank you to every game and demo coder, and every SID composer, and to every graphic artist, cracker, swapper, and everyone else in the scene, who pushed the hardware further than anyone thought possible since 1982.

A special thanks goes to the following:

Demo groups and crackers#

Fairlight · Genesis Project · Oxyron · Crest · Razor 1911 · Booze Design · Censor Design · Triad · Performers · Reflex · Bonzai · Pretzel Logic · Elysium · Smash Designs

Game developers and publishers#

Sensible Software · System 3 · Beam Software · Raffaele Cecco · Sega · Capcom · ZeroPaige · Nostalgia · Hewson · Psygnosis · Ocean · Elite · Simon Pick · Amazing Products

SID musicians#

Rob Hubbard · Martin Galway · Jeroen Tel · Chris Hülsbeck · Ben Daglish

Collections and archives#

• CSDb: the C64 Scene Database. https://csdb.dk
• Assembly64: a catalog for exploring C64 demos, intros, music, graphics and other scene productions. https://assembly64.hackerswithstyle.se/assembly/index.html
• OneLoad64: one-file C64 games collection. https://oneload64.github.io/

Achievements#

• c64-cheevos by hayesmaker (MIT): the achievement and leaderboard definitions 16 of C64 READY.'s sets are ported from (each names it in its source field, the rest are this project's own). https://github.com/hayesmaker/c64-cheevos
• C64cade: its game catalog identified the file each of those sets was made for. https://www.c64cade.com/
• RetroAchievements: the rcheevos runtime, and the condition format the sets are written in. https://retroachievements.org/

BBSes and terminal programs#

• The Oasis BBS, the board in the User Guide's user port animation. https://theoasisbbs.com/
• CCGMS Future by Craig Smith, alwyz and Michael Steil, the terminal program in that animation. https://github.com/mist64/ccgmsterm

AI collaborators#

• Claude Code (Anthropic): primary implementation collaborator.
• Codex (OpenAI): second opinion and advanced logic tasks.

Fonts#

• Inter by Rasmus Andersson, SIL OFL 1.1. https://rsms.me/inter/
• Share Tech Mono by Carrois Type Design, SIL OFL 1.1. https://fonts.google.com/specimen/Share+Tech+Mono
• PetMe64, Giana, and Berkelium64 (GEOS font) by Rebecca Bettencourt / Kreative Korporation, Kreative free-use license. https://www.kreativekorp.com/software/fonts/c64.shtml

3D model#

• Commodore 64 || Computer (Full Pack) by dark_igorek, CC BY 4.0, used for the Retro Vibes 3D viewer. https://skfb.ly/oUKFx