oaknut-disc 12.6.0

CLI for working with Acorn DFS, ADFS, and AFS disc images.

oaknut-disc

Read the documentation — full walkthrough, cookbook, and command reference.

disc is a unified command-line tool for inspecting, extracting from, and modifying Acorn computer disc images — Acorn DFS and Watford DFS floppies, ADFS floppies and hard discs, Acorn Level 3 File Server (AFS) partitions, ROM Filing System (ROMFS) images, and ZIP archives of Acorn files — through one consistent interface.

It recognises each format by content, with a filing-system prefix (dfs:, adfs:, afs:) to route commands on dual-partition images, and Acorn star-command aliases (*CAT, *DELETE, *RENAME, …) alongside their Unix-named equivalents.

Installation

oaknut-disc requires only uv, which handles Python installation and virtual environments for you.

Run without installing

uvx --from oaknut-disc disc <command> [options]

Persistent install

uv tool install oaknut-disc

then invoke it as just disc:

disc <command> [options]

Or with pip:

pip install oaknut-disc

Usage

# List the contents of a DFS floppy
disc ls 'games.ssd:$'

# Copy a file from a DFS floppy to an ADFS hard disc, mapping metadata across
disc cp 'games.ssd:$.ELITE' 'scsi0.dat:$.Elite'

# Create and initialise a Level 3 File Server disc (ADFS host + AFS tail)
disc create scsi0.dat --geometry capacity=10MB --title Server
disc afs init scsi0.dat --disc-name Server --user RJS:2MiB --emplace Library

# Walk both partitions of a dual ADFS + AFS hard disc
disc tree scsi0.dat

Licence

MIT.