Handbook

Amiga Imager v0.88

Current handbook for Amiga Imager v0.88. This guide was checked against the shipped 0.88 / 260520 build and is the current public handbook until a newer revision is published.

Download v0.88 Back to downloads
  • Verified against build 260520
  • English reference guide
  • Current until the next handbook revision
Back to downloads

What this handbook covers

This is the public day-to-day guide for Amiga Imager v0.88. It is meant to match the current app build. It covers the two main workflows, the current build screen, platform-specific notes, and the settings panes introduced in the newer releases.

What the app does

Amiga Imager is a native macOS app that builds ready-to-use Amiga systems from one workflow.

  • PiStorm / Emu68 and Classic Amiga builds are written as .img files.
  • MiSTer / Minimig builds are written as .hdf files.
  • Finished images can be written directly to SD, CF, or USB media from the app.
  • The app supports both Simple and Advanced build flows.
  • Optional community software can be added during the build.

Before you start

For a normal build you should have these items ready:

  • a Mac running macOS 14 Sonoma or later
  • a valid Kickstart ROM
  • matching AmigaOS installation media
  • a destination SD, CF, or USB device if you plan to write the image immediately
  • internet access for helper tools and optional downloads

Media expectations depend on the AmigaOS version you select:

  • AmigaOS 3.1 / 3.1.4: ADF source folder
  • AmigaOS 3.2.x: ADF source folder or 3.2 CD ISO
  • AmigaOS 3.9: CD ISO plus Boing Bag 1 and Boing Bag 2

Optional but often useful for current v0.88 builds:

  • a paid Picasso96 archive from Individual Computers for the broadest Classic RTG compatibility
  • a valid Roadshow.lha if you want Roadshow Full instead of the demo path
  • registration files for IBrowse or IMP3 if you want licensed features

The two workflows

Build bootable image

This is the main mode and the one most users will spend their time in. It lets you select a target platform, point the app at your install media and ROM, choose optional software, review a Build Summary, and generate a ready-to-use disk image.

Flash existing image

This mode writes an already built image to removable media. The UI is simple: choose the image file, choose the target disk, optionally keep Only show external disks enabled, then click Write to Disk.

Writing to physical media may ask for your administrator password. On macOS you may also need to grant Full Disk Access to Amiga Imager if raw disk access is blocked.

How the current build workflow works

1. Choose the basic inputs

  • Select Target platform: PiStorm / Emu68, Classic Amiga, or MiSTer (Minimig).
  • Choose AmigaOS version. If possible, keep it on Auto and use Check Media to verify what the app found.
  • Provide an ADF source, an ISO, or both, depending on the OS version.
  • Select your Amiga ROM.
  • Choose the output image path.

2. Decide whether to stay in Simple or switch to Advanced

Simple is the fastest route. It applies safe defaults for a first build, including bundled assets, EN plus your system locale, Roadshow Demo, and the shareware Picasso96 path when RTG is needed.

Advanced is where the full app lives. Use it when you want custom hardware choices, manual Roadshow or Picasso96 archives, transfer folders, package-specific registration files, custom image sizing, or profile save/load.

3. Work through the build cards

Input

This card is where you set the platform, OS version, media, ROM, and output image. On Classic builds it also exposes the current hardware selectors for Machine, Accelerator, RTG Graphics Card, and Network Card.

Configuration

In Advanced mode this is where current v0.88 setup choices live:

  • Display: preset or custom screen mode, Workbench depth, backdrop, icon set
  • P96 iComp archive: optional commercial Picasso96 archive for Classic RTG
  • FrameThrower: PiStorm-only video settings such as mode, autostart, scaling, size, brightness, and contrast
  • Network: None, Roadshow (Demo), or Roadshow (Full), plus Wi-Fi where supported
  • Transfer Folder: copy a host folder into the chosen Amiga partition during the build

Optional Software

Simple mode offers a one-switch community package path. The current UI describes it as including tools such as SysInfo, NoClick, MUI 3.8, IBrowse, AmiSSL, and WBDock 2.

Advanced mode exposes grouped package selection. Some packages open extra fields only when needed, for example:

  • WHDLoad Kickstarts
  • IBrowse Key
  • IMP3 Reg

Image & Build

Use this card to choose the image size and start the build. Simple mode stays on the preset path. Advanced mode exposes the full image size controls, partition layout, profile save/load, and the final build actions.

  • Build Image is used for PiStorm and Classic targets.
  • Build HDF is used for MiSTer.
  • Before the script runs, the app opens a Build Summary so you can review the current settings and warnings.
  • After a successful build you can click Use Built Image and switch straight into the write flow.

Platform notes for v0.88

PiStorm / Emu68

  • Builds use an .img output file.
  • Wi-Fi settings and FrameThrower are PiStorm-specific.
  • The PiStorm settings pane controls boot-bundle source and prerelease firmware opt-in.

Classic Amiga

  • Current RTG card choices include VA2000, P-Vision, Vampire SAGA, and ZZ9000.
  • Current network choices include A314 and ZZ9000Net alongside other Classic NICs.
  • A314 requires Roadshow. The app will flag that mismatch in the build summary if you choose A314 without a Roadshow stack.
  • v0.88 especially improves Classic reliability around RTG setup, Vampire SAGA handling, and package matching.

MiSTer / Minimig

  • Builds use an .hdf output file.
  • Optional RTG uses UAEGFX.
  • If you enable networking, MiSTer must be set to UART Mode = PPP and Baud = 115200.

Settings window (Cmd+,)

The current app has a dedicated Settings window with five panes:

  • Build: build behavior, Aminet exposure, UserFiles auto-discovery, asset folder override
  • Storage: SD-card size reduction presets so generated images still fit real media
  • PiStorm: floppy buffers, boot-bundle source, prerelease toggle, optional firmware URL override
  • Classic: A314 auto-mount behavior and optional DEVS:a314.config output
  • Debug: diagnostic output and developer-oriented behavior

If you keep the default setup, you can ignore most of these. They are mainly useful when matching specific hardware or refining repeated build workflows.

Troubleshooting

Helper tools do not install

Use Install / Retry. The app needs hst-imager before build mode can run.

The build cannot start

The most common causes are missing install media, missing Kickstart ROM, or no output image path. For AmigaOS 3.9, also check that both Boing Bag updates are present.

Writing to disk fails on macOS

Enable Full Disk Access for Amiga Imager in System Settings -> Privacy & Security -> Full Disk Access, then retry. Replugging the target device can also help.

A314 does not work

Make sure the network stack is set to Roadshow Demo or Roadshow Full. A314 is not supported with None.

The image is too large for the card

Reduce the preset, adjust the custom size, or use the storage size-reduction settings to leave more headroom for real SD media.

You need help diagnosing a problem

Use Export Log after the failure and keep the build summary details. That is the fastest way to capture the exact configuration used by the current build.