Skip to main content

Installation

An Anime Game Launcher is available for multiple Linux distributions through various package formats. The launcher developer relies on community maintainers for most packages.
Installation instructions may become outdated due to limited maintenance resources. You can help by keeping the documentation up to date.

Officially supported packages

These packages are officially supported by the An Anime Team with guaranteed functionality.

Best for: Any distribution

Works on Fedora, Pop!_OS, SteamOS, Steam Deck, and most other Linux distributions
Maintainer: Luna (available in Discord)
1

Add Flathub repository

If you haven’t already added Flathub:
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
2

Install the launcher

flatpak install moe.launcher.an-anime-game-launcher
3

Run the launcher

flatpak run moe.launcher.an-anime-game-launcher
Or launch from your application menu.
Resources:

RPM packages

Best for: Fedora, openSUSE

Available through openSUSE Build Service
Maintainer: Maroxy (Discord admin)
RPM packages are often outdated. Flatpak is strongly recommended instead.
1

Add repository

Follow the instructions for your distribution on the AAGL OBS repository.
2

Install the package

# Fedora
sudo dnf install an-anime-game-launcher

# openSUSE
sudo zypper install an-anime-game-launcher
Resources:

Community supported packages

These packages are maintained by active community members with regular contact with the An Anime Team.

Arch Linux (AUR)

Best for: Arch Linux, Manjaro, EndeavourOS

Available through the Arch User Repository
Maintainer: xstra (honorary Discord member)
1

Install using AUR helper

yay -S an-anime-game-launcher-bin
2

Run the launcher

anime-game-launcher
Resources:

NixOS

Best for: NixOS

Available as a NixOS module
Maintainer: Luxxy (honorary Discord member)
1

Add the module

Add to your NixOS configuration:
# Import the module
imports = [
  (builtins.fetchTarball {
    url = "https://github.com/ezKEa/aagl-gtk-on-nix/archive/main.tar.gz";
  })
];
2

Enable the launcher

programs.anime-game-launcher.enable = true;
3

Rebuild your system

sudo nixos-rebuild switch
Resources:

Gentoo

Best for: Gentoo

Available through custom overlay
Maintainer: johnthecoolingfan (honorary Discord member)
1

Add the overlay

# Using eselect repository
eselect repository add aagl-ebuilds git https://github.com/an-anime-team/gentoo-ebuilds

# Or using layman
layman -a aagl-ebuilds
2

Sync and install

emaint sync -r aagl-ebuilds
emerge --ask games-util/an-anime-game-launcher
Resources:

Third-party packages

These packages are maintained by third parties with minimal or no contact with the An Anime Team. The team does not verify or support these packages.

Ubuntu / Linux Mint / Pop!_OS (DEB)

Best for: Ubuntu-based distributions

Available through PPA
# Add the PPA
sudo add-apt-repository ppa:thundergemios10/an-anime-game-launcher
sudo apt update

# Install
sudo apt install an-anime-game-launcher
Resources:

Pacstall (Ubuntu)

Best for: Ubuntu users

Alternative package manager for Ubuntu
# Install using Pacstall
pacstall -I an-anime-game-launcher-bin
Resources:

Chinese version support

The launcher automatically enables Chinese version support if your system language is set to zh_cn. You can also manually change the game edition in launcher settings.
GitHub is blocked in China, which affects component downloads. You’ll need to create a custom components index repository with mirrored links and update the repository URL in ~/.local/share/anime-game-launcher/config.json.
1

Fork the components repository

Create your own copy of the components repository.
2

Update download links

Replace all GitHub release URLs with accessible mirror links in your fork.
3

Configure the launcher

Update the components index URL in your launcher’s config.json file to point to your custom repository.
For assistance, contact the developers on Discord or via email.

Post-installation

After installation, the launcher will:
  1. Create configuration directory at ~/.local/share/anime-game-launcher
  2. Create cache directory at ~/.cache/anime-game-launcher
  3. Auto-detect your system language
  4. Display the first-run setup wizard

Next: Quickstart guide

Learn how to set up and launch the game for the first time

Getting help

Discord community

Ask questions and get support from the community and developers

GitHub Wiki

Browse FAQ, troubleshooting guides, and documentation

GitHub Issues

Report bugs and track known issues

Releases

Download latest releases and view changelog

Build docs developers (and LLMs) love