Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:WOZ disk image

From ReverseEngineering.wiki
Format
Platforms Platform:Apple II
Magic 57 4F 5A 32 FF 0A 0D 0A (WOZ2)
Extensions .woz
On this wiki Facts · Code · Notes · Topics

Applesauce's bit-stream disk image for Apple II (and 3.5-inch) disks: magic WOZ1 or WOZ2, bytes FF 0A 0D 0A, a CRC32, then INFO, TMAP, TRKS (and optional META, WRIT, FLUX) chunks; it preserves quarter tracks and exact bit timing for copy-protected disks.

File header (12 bytes, all little endian)

0-3 "WOZ2" (WOZ1 for the first version), 4 0xFF (catches 7-bit transfer), 5-7 0A 0D 0A (catches line-ending conversion), 8-11 CRC32 of everything after the header (0 means not computed). Chunks follow from byte 12: 4-byte ASCII id then u32 size.

Chunks (WOZ2)

  • INFO ("INFO", 60 bytes, data at 20): +0 version (3 current), +1 disk type (1 = 5.25, 2 = 3.5), +2 write protected, +3 synchronized, +4 cleaned, +5 creator (32 bytes UTF-8 space padded); v2 adds +37 sides, +38 boot sector format, +39 optimal bit timing (125 ns units), +40 u16 compatible hardware bitfield, +42 required RAM (KiB), +44 largest track in 512-byte blocks; v3 (WOZ 2.1) adds +46 FLUX block and +48 largest flux track.
  • TMAP ("TMAP", 160 bytes, data at 88): one byte per quarter track for 5.25-inch disks (index = quarter-track position, 35.00 at +140), 0xFF for none; for 3.5-inch disks the index is (track << 1) + side.
  • TRKS ("TRKS", entries at 256): 160 TRK entries of 8 bytes (u16 starting block, u16 block count, u32 bit count) = 1280 bytes; bit data starts at 1536 (block 3), a track is at block x 512.
  • META, WRIT, FLUX optional.

WOZ1

Uses a fixed 6646 bytes per track; WOZ2 uses variable 512-byte blocks and moved write hints into WRIT.

Sources

Applesauce WOZ 2.1 reference, https://applesaucefdc.com/woz/reference2/ (read through a summarising fetch; recheck numbers against the document).