Altair Disk GUI (ADGUI)
June 5, 2025 ยท View on GitHub
Adgui gives you most of the functionality of the command line tool, with a flashier interface.
The GUI is designed to be operated solely by keyboard, but of course mouse interaction works perfectly fine as well.
When you start adgui you are greeted with the following screen:
The left grid displays the contents of the disk image, while the right grid displays the contents of the local directory.
To open up an image, you can use Alt-M or click on the left-grid's folder icon to bring up a file browser, Alt-I to jump to the Image text entry box to type in the directory name.
If you open a 5MB HDD image, you will see the following warning:

Unless there is a patched version of CPM that supports 1024 directory entries on the image, select the standard HDD_5MB option. But be warned, selecting the wrong option will corrupt your disk image, so please keep a backup, just in case.

If you hold down the ALT key, you will see the keyboard shortcuts for the whole screen. You can also use the Help->Shortcuts menu to see more information on the shortcuts and what each command does.
Here we use Ctrl-A to select all of the files in the image and then Alt-G (Get) to copy all of the files from the image to the local directory.

An example of copying files is shown below:

Some other things you might find useful
- Sorting, by clicking on the grid column headers
- There is a splitter between the grids so you can resize each grid. You can completely hide the local directory if you just want to see the altair files.
- You can drag files from the operating system and drop them into the application. SDL does not currently support dragging files out of the application, so it is one-way functionality for now.
- Use Ctrl-C to copy the list of filenames from an image to the clipboard. If no files are selected, all filesnames are copied, otherwise the selected filesnames are copied.
Keyboard Shortcuts
