Windows 32bit or 64bit:

Cygwin/32

see Vincent's site for link to installer

Environment Variables

configure $AGTROOT to point at the agtools repo directory. e.g.

> export AGTROOT="$HOME/Projects/agtools"

You can add an equivalent line to your profile to ensure it is configured each time you log in.

GNU make

Use the Cygwin package installer

Atari MiNT GCC 4.6.4

see Vincent's site for link to installer

GIT SCM

Optional, but preferred for keeping the source repo up-to-date, compared with downloading the .zip snapshots. If you don't have experience with GIT, better stick with the .zip files until you're comfortable with it.

(There are also several GUIs available for GIT on Windows).

Ubuntu:

AGT has been tested on Ubuntu 16.10. It should work on any distro providing you can install the prerequisites:

Environment Variables

configure $AGTROOT to point at the agtools repo directory. e.g.

> export AGTROOT="$HOME/Projects/agtools"

You can add an equivalent line to your profile to ensure it is configured each time you log in.

GIT SCM

> sudo apt-get install mercurial

Wine Windows emulator

> sudo apt-get install wine-stable

Atari MiNT GCC 4.6.4

follow this link for instructions

Note: while Ubuntu 16.10 is the currently supported release, some earlier releases still have support. Change the deb source to suit:

Release         Name                Source Dir
16.10           Yakkety Yak         yakkety/
16.04           Xenial Xerus        xenial/
14.04           Trusty Tahr         trusty/
12.04           Precise Pangolin    precise/

MacOSX/Darwin:

configure $AGTROOT to point at the agtools repo directory. e.g.

> export AGTROOT="$HOME/Projects/agtools"

You can add an equivalent line to your profile to ensure it is configured each time you log in.

The MacOS version previously used WINE to wrap Windows tools in exactly the same way as the Linux version. However this stopped working with Catalina. Now MacOS uses native builds of the AGT tools (under bin/mac).

Note: Only 'agtcut' and 'rmac' are provided. This is enough to use most of the samples but not all. Some tools are still missing.

GIT: Non-Windows Systems:

If using GIT from the commandline, obtain an initial clone of the source repo with the command below. You only need to do this once.

> git clone https://d_m_l@bitbucket.org/d_m_l/agtools.git

To pull new changes from BitBucket use:

> git pull

Note: GIT can be 'fun' at times, so practise & experimentation is recommended if you are not familiar with it.

GIT: Windows Systems:

On Windows you may use TortoiseGit, Tower, SmartGIT or any other GUI version you happen to like. Otherwise you can use GIT in the same way as for non-windows systems (commandline version) after installing it via the Cygwin package mananger or as native Windows tools.

Troubleshooting:

One of the sprite cutting formats (.emx) requires the 68k assembler rmac to generate the binary data for each sprite frame. agtcut will try to shell out to rmac.exe in order to do this. However it expects to find rmac on the system path.

So if you get errors from agtcut trying to invoke rmac, either add the tool to your (Windows) $PATH or switch to one of the other sprite formats which doesn't depend on the assembler (.ims, .ems).