Skip to content

First Installation

Christer Solskogen edited this page Jun 11, 2024 · 12 revisions

Requirements

  • Any recent Linux OS (Debian Bullseye or later), or macOS for Apple hardware (x86/apple silicon) if you're running that.
  • These extra libraries: libsdl2-2.0-0 libsdl2-ttf-2.0-0 libsdl2-image-2.0-0 flac mpg123 libmpeg2-4 libserialport0 libportmidi. MacOS users need to install these using Homebrew (check installation instructions here: https://github.com/BlitterStudio/amiberry/wiki/Compiling-for-macOS
  • Your own Amiga Kickstart ROMs. You can use the encrypted Amiga Forever ones as well, if you include the "key.rom" file with them in the same directory. Newer versions of Amiga Forever don't include a key, but they require you to run Amiga Forever once, to decrypt them. Copy them over after that step.

Which version should I pick?

Amiberry nowadays has two versions available:

v5.x

  • Based on WinUAE 4.4.0.

  • Good balance of compatibility and performance (but not perfect).

  • Includes "Fast Copper" hack, to speed up certain games that might benefit from it. Might cause glitches elsewhere!

  • Cycle accurate for 68000 mode only, stripped down CPU emulation for other models. Models higher than 020 (030-040) don't use proper CPU cycles, they are just faked using 020 (they still show up as the selected model under emulation, of course). No 68060 support.

  • Includes JIT for ARM (not on MacOS).

  • Recommended for slower hardware (up to RPI4), or if you want JIT for ARM.

v6.x (Preview)

  • Based on the latest WinUAE available.

  • Most accurate version, but heavier on CPU requirements than v5.x.

  • Includes full CPU (68000-68060) cycle-accurate emulation, latest chipset emulation updates.

  • JIT for x86_64 (not on MacOS).

  • MMU support.

  • Debugger (console-based).

  • Recommended for all platforms faster than the RPI4, including all macOS and x86_64 platforms

Clone this wiki locally