ATR_Tools is a simple command line tool to create SIO2PC ATR files.

ATR files are used in Atari 8bit emulators and modern hardware extensions for original Atari 8Bit computer.

While SIO2PC can create these files as well SIO2PC is only available for Windows. Because of this restriction I created a small tool to create can ATR files which will compile on Linux and macOS.

I suggest to compile the file from source code as it is fairly simple will match your operating system.

Microsoft Windows

Install Alire

Download Alire from the Alire website:

Start installation and just accept the defaults:

Build the application

Start the application by clicking on the icon. This will open the Alire powershell terminal window:

Use cd to change into an directory of your choosing and type the following commands one at a time. Note the the directory name contains the version number and and hash code of current version and will change with each new release.

alr toolchain --install "gnat"
alr toolchain --install "gprbuild"
alr get "atari_atr_tools"
PUSHD "atari_atr_tools_1.1.3_1e2cccbb"
  alr build --release
POPD

During the build Alire ask 4 questions which should be answered with either Y or 1 depending on the type of question. This will build the tool for your machine.

Run the Application

The finished application inside the .\atari_atr_tools_1.1.3_1e2cccbb\bin\atr_tools-main.exe directory. Again: adjust for newer Versions. The --help option will show you available options.

Apple macOS

Install Alire

Download Alire from the Alire website:

The Alire distribution for macOS is just an executable inside a zip file. You can extract the zip to any location you like and add the executable flag to the alr binary.

Build the application

Start Terminal and change into an directory of your choosing and type the following commands one at a time. Note the directory name contains the version number and hash code of current version and will change with each new release.

bin/alr toolchain --install "gnat"
bin/alr toolchain --install "gprbuild"
bin/alr get "atari_atr_tools"
pushd "atari_atr_tools_1.1.3_1e2cccbb"
  ../bin/alr build --release
popd

During the build Alire ask up to 4 questions which should be answered with either Y or 1 depending on the type of question. This will build the tool for your machine.

Run the Application

The finished application is found at ./atari_atr_tools_1.1.3_1e2cccbb/bin/atr_tools-main. Again: adjust for newer Versions. The --help option will show you available options.

SuSE Linux

Install Alire on

Download Alire from the Alire website:

The Alire distribution for Linux is just an executable inside a zip file. You can extract the zip to any location you like and add the executable flag to the alr binary.

Build the application

bin/alr toolchain --install "gnat_native>=12"
bin/alr toolchain --install "gprbuild>=22"
bin/alr get "atari_atr_tools"
pushd "atari_atr_tools_1.1.3_1e2cccbb"
  ../bin/alr build --release
popd

During the build Alire ask up to 4 questions which should be answered with either Y or 1 depending on the type of question. This will build the tool for your machine.

Run the Application

The finished application is found at ./atari_atr_tools_1.1.3_1e2cccbb/bin/atr_tools-main. Again: adjust for newer Versions. The --help option will show you available options.