ADTPro on a Raspberry Pi

Oct. 31, 2019

For all retro Apple II enthusiasts ADTPro is a tool you can't live without since it allows you to backup your Apple II disks or create new ones from a variety of sources.
This post is about how to setup ADTPro from scratch on Linux. An alternative to installing ADTPro by hand on an existing Pi would be to install a full 'Apple II Linux image' like A2Cloud. Doing things by hand also gives us more control, in case we want to tweak things. In my case tweaking things is necessary anyway, since I'm using an USB adapter that is not supported out of the box by Linux (and which I could not get to work on modern macOS versions anyhow).

Ok, so let's get started. First here's a list of stuff I used:

Raspberry Pi setup

Installing a Linux distribution on a Pi is easy, if you've followed a tutorial like this. I've used the Buster Lite image, since I am planning to use the Pi headless (i.e. without a display attached to it).

After you've installed Debian on your Pi, have booted it, and logged in. You may want to enable SSH on it, so you can login remotely. From this point onwards, you will not be needing the display for your Pi anymore (if you want to).

Extra software

Because ADTPro is a Java program we need Java installed: sudo apt install openjdk-8-jdk. Note that I installed the development kit, the runtime environment would probably have been sufficient for what we're doing, and faster, so grab a cup of coffee while waiting.

ADTPro installation

It is quite easy to build ADTPro from source. You will just need a JDK and the Ant build system. For this tutorial we will use a pre-build version, version 2.0.3. Just download it from this page (using wget) and unzip it.

Now cd to directory ADTPro-2.0.3. There are bunch of files here that are not runnable, yet. By issuing the command chmod +x we can make the ADTPro shell script runnable.


You can download and install XQuartz from its website. After it is installed you should open up its preferences and make sure that the 'Click-through Inactive Windows' checkbox is checked on the Windows tab. Without this checked, the ADTPro window does not respond to mouse clicks.

From an XQuartz terminal window, we now can connect to the Pi with this command: ssh -X pi@<IP of your Pi>.
The '-X' switch in the command will make sure that all XWindows windows will be created on our Mac, within the XQuartz environment.

After you have connected to Pi via SSH, it is simply a matter starting the shell script. After a little while the ADTPro UI should be displayed on your Mac.

Next steps are bootstrapping ADTPro or just send disks to backup your existing pile of disks. Enjoy!

smashtunes logo

SmashTunes is a Mac app that displays Spotify and Apple Music track info in the white space of the menu bar, so you can see what's playing in one quick more...

Kid's Lingo is an educational iPhone and iPad game for children. The aim of the game is to guess words from a set of words that are known to them from primary school. This makes them learn words and improve their spelling more...

klingo logo
View all blog entries