Ready-Built AtariSIO Tools for Windows, macOS and Linux
On 3 June 2023 JAC!, who maintains the WUDSN tools, announced ready-to-run binary builds of the AtariSIO tools, collected in one place for convenience. The tools are by Matthias Reichl (HiassofT) and are part of his AtariSIO package for Linux. JAC! built them for Windows and for Intel and Apple Silicon macOS, then added Linux x86-64 builds. Another forum member, sanny, supplied PowerPC Mac versions. All of them are in the WUDSN tools repository on GitHub.
The three tools
dir2atr turns a folder on your PC into a disk image. If you give no size, it works one out that fits all the files. Switches create images that match real media: -S 90K single density, -E 130K enhanced, -D 180K double and -Q 360K. A 720- or 1040-sector image is written in standard DOS 2.x format; anything else uses MyDOS format, with subdirectories included. It can also make the image bootable:
-bwrites boot sectors for DOS 2.0/2.5, OS/A+, DOS XL, MyDOS, Turbo DOS, XDOS or one of many MyPicoDos variants (with or without high-speed SIO).-Pwrites aPICONAME.TXTso MyPicoDos menus show long file names.-asets MyPicoDos to autorun the only file on the disk.
For example:
dir2atr -d -b MyPicoDos405 -P games.atr my_games_dir
builds a double-density, bootable MyPicoDos game disk with long names from a folder.
adir lists the DOS 2.x directory of one or more images (adir *.atr). Use -t to descend into MyDOS subdirectories and -r for raw sector details.
ataricom is a Swiss-army knife for Atari executables (COM/EXE/XEX). On its own it lists every load block with its addresses, length and file offset, and shows any RUN or INIT vectors. It can also:
- extract blocks to separate files (
-e/-E) - keep or drop chosen blocks (
-b/-x) - merge (
-m) or split (-s) blocks - add RUN or INIT addresses (
-r/-i) - wrap a raw binary as a load file (
-c) - strip headers to raw data (
-n)
Why it matters
These small programs fit neatly into a cross-development workflow, for packaging a freshly assembled .xex onto a bootable disk or checking what a load file contains. With ready-made binaries, Windows, Mac and Linux users can drop them into a makefile or IDE without compiling anything.
The thread also answered the obvious question: how do you get files out of an ATR? For SpartaDOS-format images, dmsc pointed to his mkatr/lsatr tools, which create images and list or extract their contents. atrcompiler was also suggested, and an extract feature was filed as a request for AtariSIO.
Getting it
The binaries are in github.com/wudsn/wudsn-ide-tools under ATR/AtariSIO/tools (dir2atr, adir and ataricom, each as .exe and as Linux x86-64, macOS x86-64, aarch64 and PPC builds). The source is at github.com/HiassofT/AtariSIO, and the full option list is in its README-tools file.
Credits
- AtariAge — AtariSIO Tools (ataricom, adir, diratr) Binary Builds — AtariAge forum members
- AtariSIO README and README-tools (Matthias Reichl) — GitHub project authors
- WUDSN IDE tools repository — ATR/AtariSIO/tools (file listing) — GitHub project authors
