Repository navigation
atariATR 1.2
Images without a file system — raw disk dumps with their own loader — are no
longer a dead end. Instead of refusing to open them, the plugin now shows a single
virtual file describing the image, and atrtool list prints the same description.
Polski opis projektu: README.pl.md
What's new since 1.1
Around 45% of real .atr files contain no file system at all: the boot sectors
hold a custom loader that reads data straight off sectors. Every tool has to give
up on listing files there — but it can still say something useful.
Entering such an image in Total Commander or Double Commander now shows one
read-only virtual file, INFO-DYSK.TXT, containing:
- disk parameters: sector size, sector count as declared by the header and
as actually present in the file — these often differ, and that difference
is exactly why some viewers report a different geometry than others, - a decoded Atari boot record: how many sectors the loader reads, its load and
init addresses, the first 16 bytes, and whether the code starts with aJMP, - what was checked and not found (DOS 2.x VTOC at sector 360, SDFS signature at
boot byte 7), so the verdict is not a black box, - a warning that writing to such an image would overwrite the loader.
Writing to these images is refused with E_NOT_SUPPORTED rather than attempted.
atrtool list prints the same text and exits successfully — a raw dump is a normal
kind of image, not an error.
Assets
| File | What it is |
|---|---|
atrtool-1.2-windows-x64.exe |
command line tool, 64-bit Windows |
atrtool-1.2-macos-arm64 |
command line tool, Apple Silicon |
atrtool-1.2-macos-x86_64 |
command line tool, Intel Mac |
atrtool-1.2-linux-x86_64 |
command line tool, Linux |
AtrWcx-1.2.zip |
Total Commander plugin — drag onto TC to install |
AtrWcx-1.2-macos-arm64.wcx |
Double Commander plugin, Apple Silicon |
AtrWcx-1.2-macos-x86_64.wcx |
Double Commander plugin, Intel Mac |
AtrWcx-1.2-linux-x86_64.wcx |
Double Commander plugin, Linux |
SHA256SUMS.txt |
checksums |
There is still no 32-bit .wcx; build it on Windows with a 32-bit Free Pascal
(build/build-wcx.sh win32) if you use a 32-bit Total Commander.
macOS: downloads are unsigned, so clear the quarantine flag once:
xattr -d com.apple.quarantine atrtool-1.2-macos-* AtrWcx-1.2-macos-*.wcx
chmod +x atrtool-1.2-macos-*Verification
The plugin test harness grew a scenario for images without a file system: it
checks that such an image opens, that the virtual file is visible, read-only and
extractable with sensible content, and that adding or deleting files is refused.
47 checks in total across MyDOS, SpartaDOS and raw images, plus the dynamic load
check on every platform.
Everything from 1.1 still holds: round-trip on 1705 real images (1689
byte-identical), 943 read as file systems and 760 correctly identified as having
none, byte-exact cross-validation against lsatr from
mkatr, and an 8 MB MyDOS image created by this
code booting on real MyDOS in an emulator.