Skip to content

atariATR 1.2

Choose a tag to compare

@github-actions github-actions released this 29 Jul 09:54
· 24 commits to main since this release

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 a JMP,
  • 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.