WHDLoad Workflow

WHDLoad Workflow

This page provides a quick, reliable setup flow for WHDLoad titles in Amiberry. For deeper details, see WHDLoad Auto-booting, WHDLoad Booter FAQ, and WHDLoad Panel.

1) Prepare prerequisites

• Kickstart ROMs installed (see Kickstart ROMs (BIOS)).
• WHDLoad archives (.lha) available in your WHDLoad path.
• WHDLoad boot files available in the whdboot directory (Amiberry can download these if missing).

2) Set your paths

Go to the Paths panel and set:

• WHDLoad Archives path
• Kickstarts path
• Configurations path (if you want per-title configs)

Click Rescan Paths after changes.

3) Load a WHDLoad title

Use any of the following:

• WHDLoad Panel
• Quickstart (WHDLoad Auto-boot section)
• Command line (amiberry MyGame.lha)

If recognized, Amiberry will auto-populate fields and apply recommended settings from the WHDLoad XML database.

4) Save per-title configuration (optional)

If you want per‑title overrides:

• Load the .lha and confirm settings
• Save the configuration under the same base name as the archive
• Amiberry will auto‑use it for future loads

5) Common pitfalls

Title boots to Workbench

• The .lha is not recognized in the XML database.
• The WHDLoad archive is in the wrong folder.
• The WHDLoad boot files are missing.

Missing or incorrect settings

• The XML database entry is outdated or missing fields.
• You saved a .uae config without loading the .lha first.

No input / wrong input

• Check default controller/mouse in Input and Custom Controls.
• Ensure RetroArch mappings (if used) are configured in Paths.

6) Advanced options

• Use Custom Fields in the WHDLoad Panel to tweak per‑title options.
• Edit the WHDLoad database if needed (see WHDLoad DB Structure).