Amiberry
Amiberry emulates Commodore Amiga, Commodore Amiga CD32 and Commodore CDTV. It reads 261 files, 1 of them required: without a required file it does not start games. A required file is needed only by the machines that use it. Each file below cites the line of source code that reads it.
Run on its own, the app keeps its data in this folder:
%USERPROFILE%/Amiberry/
AMIBERRY_HOME_DIR overrides it. An amiberry.portable file beside the executable makes its folder the root. rom_path and base_content_path in amiberry.conf move ROMs.
Source: src/, src/, src/, src/, src/osdep/amiberry.cpp:13286
~/Documents/Amiberry/
AMIBERRY_HOME_DIR overrides it. rom_path and base_content_path in amiberry.conf move ROMs.
Source: src/, src/, src/, src/, src/osdep/amiberry.cpp:13286
~/Amiberry/
AMIBERRY_HOME_DIR overrides it, and an amiberry.portable file beside the executable makes its folder the root. Outside portable mode WHDBoot sits in $XDG_DATA_HOME/amiberry, else ~/.local/share/amiberry. rom_path and base_content_path in amiberry.conf move ROMs.
Source: src/, src/, src/, src/, src/osdep/amiberry.cpp:13286
Android/, on the internal storage.
Source: src/, src/, src/, src/osdep/amiberry.cpp:13286, android/app/build.gradle:118
Documents/Amiberry/
Source: src/, src/, src/, src/osdep/amiberry.cpp:13286
About this profile
Install this emulator's files
For Amiberry inside RetroArch, Batocera or another setup. The installer finds your setup and its BIOS folder, then downloads only the files this emulator reads there and checks each one.
Open the Start menu. Type PowerShell and open it. Paste the line. Press Enter.
&([scriptblock]::Create((irm https://abdess.github.io/retrobios/i.ps1))) --emulator amiberryOpen Terminal, in Applications, then Utilities. Paste the line. Press Return.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator amiberryOpen a terminal. Paste the line. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator amiberrySwitch to Desktop Mode. Open Konsole. Paste with Ctrl+Shift+V. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator amiberryInstall Termux, a terminal app. Run pkg install python and termux-setup-storage once. Then paste the line. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator amiberryOpen a terminal on the device. Or connect from a computer with SSH, a terminal over the network. Paste the line. Press Enter.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --emulator amiberryTechnical notes
Amiberry is an Amiga emulator based on WinUAE, available as both standalone and libretro core. No built-in kickstart: requires a real Kickstart ROM or external AROS replacement files (aros-ext.bin + aros-rom.bin).
Libretro core option "amiberry_kickstart" overrides ROM selection: auto, kick.rom, kick13.rom, kick20.rom, kick31.rom, kick205.rom, kick40068.A1200, kick40068.A4000, cd32.rom, cdtv.rom. "auto" selects per model. ref: libretro/libretro.cpp:694,761-780
Libretro Kickstart directory detection (in order): save_dir/Kickstarts, save_dir/whdboot/save-data/Kickstarts, system_dir/Kickstarts, system_dir/whdboot/save-data/Kickstarts, system_dir/amiberry/whdboot/save-data/Kickstarts, system_dir/save-data/Kickstarts, else system_dir. system_dir stays first in the ROM multipath, the detected directory follows it. ref: libretro/libretro.cpp:4537-4575
Standalone ROM path: configurable via amiberry.conf "rom_path" setting. kickstart_rom_file and kickstart_ext_rom_file are opened as given, with no hash check. When the main ROM is not found there, the fallback order is {home_dir}/roms/kick.rom, {home_dir}/kick.rom, ../shared/rom/kick.rom, ../System/rom/kick.rom, then ROM database guess. ref: src/cfgfile.cpp:6660-6661, src/memory.cpp:1843-1866, src/memory.cpp:2116-2158
ROM identification uses SHA1 against the WinUAE ROM database but does not reject unknown ROMs. Cloanto encrypted ROMs supported with rom.key. ref: src/rommgr.cpp:122-1110,1743-1816
WITH_CPUBOARD is always defined, so expansion boards, freezer cartridges and CPU boards read their ROMs from the same database. A CPU board whose ROM is missing does not start, and the quickstart configs that select one (A1200 configs 2-5, A4000 config 2) count as not installed without it. ref: src/osdep/sysconfig.h:191-192, src/cpuboard.cpp:2897-2954, src/cfgfile.cpp:10030-10040, src/cfgfile.cpp:10277-10364, src/osdep/settings/settings_presets.cpp:398-415
Munt MT-32/CM-32L emulation compiled in (WITH_MIDIEMU). ROMs loaded from mt32-roms/ subdirectory of the ROM path. Split ROM pairs supported (e.g. pcm_mt32_l.rom + pcm_mt32_h.rom). ref: src/midiemu.cpp:82-165
Keyboard MCU emulation (keyboard_mode setting) loads MCU ROMs via ROM database scanning. Three MCU types supported: 6570-036 (A500/A600/A1000), 68HC05 (A1200), D8039HLC (A2000). ref: src/kbmcu/keyboard_mcu_6500_1.cpp:385, src/kbmcu/keyboard_mcu_6805.cpp:544, src/kbmcu/keyboard_mcu_d8039hlc.cpp:235
WHDLoad autoboot reads the whdboot/ directory: boot-data.zip (or a boot-data directory), WHDLoad or JST, host-quit, the skick346 RTB files and game-data/whdload_db.json with game-data/whdload_db.xml as fallback. The standalone build ships boot-data.zip, host-quit, the database and the A1000 RTB file, and downloads WHDLoad, JST and the skick346 RTB files on request. The libretro core downloads nothing and names the missing tool in a message. ref: src/osdep/amiberry_whdbooter.cpp:1676-1678,1828-1847,1888-1943, src/osdep/amiberry.cpp:12257-12267
261 files: 1 required, 260 optional. 4 have an HLE fallback.
Amiberry reads more files than one page holds: each entry below links to its card, on 2 pages: 1, 2.
Required
Section titled “Required”| File |
|---|
kick13.rom |
Optional
Section titled “Optional”In this collection: 237 in repo and 24 missing.
Next steps
Section titled “Next steps”- Get your files, for the setup you play on
- Every system, and the files each one needs
- When a game does not start