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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file oaknut_disc-12.13.1.tar.gz.
File metadata
- Download URL: oaknut_disc-12.13.1.tar.gz
- Upload date:
- Size: 104.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fd5e1abe9a5f058b965ee39a7d9c6e25353490027cecd3c683f38e46943a1618
|
|
| MD5 |
b6e43e8a22d9fecbf0cf8b72cac069f9
|
|
| BLAKE2b-256 |
6f11c27da0681b66b461dc79af95b2d8aaad45f0fe86e2367f5d2b858e4a3eaa
|
File details
Details for the file oaknut_disc-12.13.1-py3-none-any.whl.
File metadata
- Download URL: oaknut_disc-12.13.1-py3-none-any.whl
- Upload date:
- Size: 45.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
652f8a69ae415bf5bd2e8c6dbdb13ca24cd770f4cf42e3e945d8a0536a21414a
|
|
| MD5 |
cf04b7a348e4f345b3e55c0f164f3109
|
|
| BLAKE2b-256 |
9d711ecf52e8ad4712a623accbd4ddcc8dd76e3215a2f9fd02e2c10ee9c9967f
|
