Adam Sampson 9931c27d6c
enhancement: use XDG_*_HOME in a more standard way (#1458)
These variables are defined in the XDG Base Directory specification
(https://specifications.freedesktop.org/basedir-spec/latest/).

Previously, amiberry only used the XDG directories if XDG_DATA_HOME or
XDG_CONFIG_HOME were defined. However, these variables are usually only
set if the user wants to use a non-standard directory (e.g. in the
Flatpak environment).

After this commit, amiberry now computes the standard default values for
these variables based on HOME if they aren't defined, and checks for the
existence of:

- XDG_DATA_HOME/amiberry - used as Amiberry's home directory
- XDG_DATA_HOME/amiberry/data - used as Amiberry's data directory
- XDG_CONFIG_HOME/amiberry - used as Amiberry's config directory
- XDG_DATA_HOME/amiberry/conf - used as Amiberry's config directory

If they don't exist, then ~/Amiberry will be created and used as before.

The effect of this is that if a user wants to avoid having ~/Amiberry in
their home directory, they can just rename ~/Amiberry to
~/.local/state/amiberry, and it'll use that path instead. They can
optionally move Amiberry/conf to ~/.config/amiberry as well.
2024-10-06 11:24:23 +02:00
2024-09-30 18:38:55 +02:00
2024-09-30 18:38:55 +02:00
2024-09-24 08:10:53 +02:00
2024-08-30 19:55:14 +02:00

Optimized Amiga emulator for multiple platforms

ko-fi

Follow me Mastodon!

C/C++ CI

Discord

Amiberry logo

Amiberry is an optimized Amiga emulator for Intel/AMD, ARM (32bit and 64bit) and RISC-V platforms. It runs on both Linux and macOS. Windows users should use WinUAE, even if Amiberry can run on WSL (Windows Subsystem for Linux).

The core emulation comes from WinUAE, and even the main GUI is designed to look similar to that. It includes JIT support, to get high-performance results on CPU-intensive emulated environments, like desktop applications. On top of that, there are some unique features developed specifically for Amiberry, such as the WHDLoad booter, support for RetroArch controller mapping, and several more.

There are currently two Amiberry editions available: Amiberry and Amiberry-Lite - see here to see which is the best pick for your needs.

Getting Amiberry

DEB packages

Amiberry is available as a DEB package for ARM32, ARM64(aarch64) and x86_64 Debian-based Linux platforms. You can download the latest version from the Releases area. Then, assuming you have it in your current directory, you can install it with:

  sudo apt update && sudo apt install ./amiberry_7.0.0_arm64.deb

If you on Arch Linux you'll find Amiberry on the AUR or if you use an AUR helper like yay, you can build and run:

  yay -S amiberry

macOS

Amiberry is available as a DMG package for macOS. You can download the latest version from the Releases area. After installing it in your Applications folder, you'll need to open a console and run xattr -rd com.apple.quarantine Amiberry.app, to whitelist it and allow it to run.

Distro package management

Some distros (like RetroPie, DietPi, Pimiga and others) already include Amiberry either pre-installed, or through their package management systems. Please follow the methods provided in those distros for a smoother experience, and refer to their owners for support during this process.

Flatpak

A flatpak version is available on Flathub

Compile from source

Alternatively, you can compile the latest version of Amiberry from source.

For more documentation subjects, please check the Wiki page

Description
No description provided
Readme GPL-3.0 78 MiB
Languages
C++ 88.5%
C 11.1%
Assembly 0.3%