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.

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.

OpenMandriva Linux

Install Alire

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

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 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

Both applications support the --help option to show you the available options. Remember to adjust the directory name for newer Versions.

atari_atr_tools

The finished application is found at ./atari_atr_tools_1.5.0_5ab5b171/bin/atr_tools-main.

atari_exe_tools

The finished application is found at ./atari_exe_tools_1.5.0_cfa98435/bin/exe_tools-main.

SuSE Linux

Install Alire

Download Alire from the Alire website:

The Alire distribution for Lunux 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_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

Both applications support the --help option to show you the available options. Remember to adjust the directory name for newer Versions.

atari_atr_tools

The finished application is found at ./atari_atr_tools_1.5.0_5ab5b171/bin/atr_tools-main.

atari_exe_tools

The finished application is found at ./atari_exe_tools_1.5.0_cfa98435/bin/exe_tools-main.