GUI Paths

Paths Panel

Configures the directories and files Amiberry uses to locate ROMs, configurations, disk images, and other resources.

amiberry.conf and amiberry.ini are bootstrap settings files and are stored in Amiberry's platform settings location, not in the Configuration files path shown in this panel.

Portable mode

On Windows and Linux desktop builds, the top of this panel includes a Portable mode toggle.

• It creates or removes the amiberry.portable marker next to the executable
• A restart is required before the full path layout changes over
• Portable mode resolves writable managed paths relative to the executable directory, not the current working directory
• The toggle is disabled if Amiberry cannot update files in the application directory
• If you want a self-contained Windows install in that case, use the official portable ZIP release
• Official Windows portable ZIP releases already include this marker by default
• macOS shows the control disabled, and Android does not expose it

Path Settings

Each path entry shows a label, an editable text field, and a ... browse button that opens a directory or file picker. Paths shown in red indicate the directory or file does not exist.

Base content folder

• Optional bulk root for Amiberry's standard content directories
• When set, Amiberry derives the standard folders below from this root using the platform's normal naming convention
• Visual assets are stored in a separate Visuals / visuals subtree, not inside Configuration files
• Edits are staged in the field until you click Apply
• If the selected root is missing managed folders, Amiberry lists them and lets you choose whether to create them before applying the change
• Editing an individual path below makes that entry an explicit override
• Clearing the field removes the bulk root and returns only the still-derived entries to their default locations, preserving any individual overrides
• This does not move the bootstrap location of amiberry.conf or amiberry.ini; it changes the managed content/config directories stored inside amiberry.conf

System ROMs

• Directory where Kickstart ROM files are stored
• Amiberry scans this directory to populate the ROM list in the ROM panel

Configuration files

• Directory where .uae machine configuration files are saved and loaded
• Corresponds to the list shown in the Configurations panel
• Visual assets such as Themes, Shaders, and Bezels live in the separate Visuals / visuals subtree instead

NVRAM files

• Directory for non-volatile RAM files used by CD32 and CDTV emulation

Plugin files

• Directory for plugin files (for example FloppyBridge drivers)

Screenshots

• Directory where screenshots are saved when using the screenshot function

State files

• Directory where save state files (.uss) are stored and loaded from

Controller files

• Directory containing SDL game controller mapping files (gamecontrollerdb.txt)

RetroArch config file

• Path to the RetroArch configuration file (.cfg)
• Used to import RetroArch controller mappings

WHDBoot files

• Directory containing WHDLoad boot files (WHDLoad executable, JST, AmiQuit, boot-data.zip, and RTB files)

WHDLoad Archives (LHA)

• Directory where WHDLoad game archives (.lha) are stored
• Used by the Quickstart panel's WHDLoad auto-config feature

Floppies path

• Default directory opened when browsing for floppy disk images

CD-ROMs path

• Default directory opened when browsing for CD image files

Hard drives path

• Default directory opened when browsing for hard drive image files

Logging Options

Enable logging

• Writes debug and diagnostic information to a log file
• Useful for troubleshooting emulation issues

Log to console

• Also outputs log messages to the terminal/console in addition to the log file

Logfile path

• Path to the log file where messages are written when logging is enabled

Actions

Reset to Defaults

• Clears the optional Base content folder override
• Restores the platform-default directory layout

Rescan Paths

• Creates any missing managed folders for the currently configured paths
• Rescans the ROM directory and updates the ROM list
• Reinitializes joystick/gamepad devices
• Recreates ROM symlinks

Update WHDBooter files

• Downloads the latest WHDLoad executable, JST, AmiQuit, boot-data.zip, Kickstart RTB files, and the WHDLoad game database from the Amiberry GitHub repositories

Update Controllers DB

• Downloads the latest gamecontrollerdb.txt from the SDL_GameControllerDB repository and reinitializes joystick devices