Skip to content

atariATR 1.5

Choose a tag to compare

@github-actions github-actions released this 29 Jul 13:16
· 18 commits to main since this release

Adds a second plugin: a file system plugin (WFX) for Total Commander and
Double Commander. The packer plugin stays — they do different jobs.

Polski opis projektu: README.pl.md

Why a second plugin

The archive interface has no functions for renaming, moving inside the image,
setting attributes or setting file dates — so no packer plugin can offer them,
however well written. A file system plugin has all of them, plus custom panel
columns:

Packer (WCX) File system (WFX)
Enter an .atr clicked in the panel yes no — images come from a list
Browse, copy in and out, delete yes yes
Create directory yes yes
Rename (F2) no yes
Move within the image no yes
Attributes (Atari lock ↔ read-only) no yes
File dates (SpartaDOS) no yes
Extra panel columns no yes

The extra columns show what a fixed archive listing has no room for: starting
sector, sector count, the image's file system, the 16-bit link flag and Atari
attributes — sortable, like any other column.

File dates required one addition to the engine (SetTimestamp). SpartaDOS stores
a date and time per file, so copying into such an image now preserves the date
from disk. MyDOS has no date field at all, and the plugin reports that honestly
instead of pretending it worked.

Configuring it

A file system plugin is not tied to a clicked file, so it needs to know which
images to show. Enter Atari ATR among the network connections and you will
find one file, _LISTA-OBRAZOW.TXT. Press F3 to read it — its first line tells
you where it lives on disk — or F4 to edit it, then refresh the panel. One
entry per line, either an image or a directory:

C:\Atari\images
C:\Atari\games\labyrinth.atr

ATRWFX_CONFIG overrides the location of that list.

Assets

atrtool for Windows x64, macOS (arm64, Intel) and Linux. Two installable
packages for Total Commander: AtrWcx-1.5.zip (packer) and AtrWfx-1.5.zip
(file system). Native plugins for Double Commander: AtrWcx-*.wcx and
AtrWfx-*.wfx for macOS (arm64, Intel) and Linux. Checksums in SHA256SUMS.txt.

Still no 32-bit builds — see earlier releases for why.

Verification

tests/wfx-harness drives the plugin the way a file manager does and checks 57
operations across MyDOS and SpartaDOS: listing, copying both ways, the
"file exists" answer without an overwrite flag, renaming, creating directories,
moving into them, attributes, dates and the custom columns. tests/wfx-loadcheck
confirms all 27 entry points resolve through dlopen/dlsym, the check that
caught the macOS symbol-underscore trap in the packer plugin.

Both plugins were then tested by hand in Total Commander and Double Commander.
Everything from previous releases still passes: 67 packer checks, round-trip on
1705 real images, 943 read as file systems, cross-validation against lsatr.

Known limitations

  • Moving a whole directory in one call reports "not supported"; file managers do
    it themselves by creating the directory, moving the contents and removing the
    original, so the result is the same.
  • Moving files between two different images is left to the file manager as a
    download-and-upload.
  • SDFS writing still covers 128 and 256 byte sectors only.