Skip to main content

Overview

Flatpak is the officially supported package format for An Anime Game Launcher, maintained by the An Anime Team. It provides universal compatibility across Linux distributions including Fedora, Pop!_OS, SteamOS, and Steam Deck.

Official Package Information

The Flatpak package is officially supported by the An Anime Team and is the recommended installation method for most users.
PropertyValue
MaintainerLuna (available in Discord)
Source Repositoryflatpak-builds
Supported DistributionsAny (Fedora, Pop!_OS, SteamOS / Steam Deck, etc.)
Installation WikiFlatpak Installation Guide

Package Metadata

The Flatpak package uses metadata from Cargo.toml:
[package]
name = "anime-game-launcher"
version = "3.18.0"
description = "Anime Game launcher"
authors = ["Nikita Podvirnyi <[email protected]>"]
homepage = "https://github.com/an-anime-team/an-anime-game-launcher"
repository = "https://github.com/an-anime-team/an-anime-game-launcher"
license = "GPL-3.0"

Building the Flatpak

Prerequisites

Ensure you have the Flatpak build tools installed:
# Fedora
sudo dnf install flatpak-builder

# Ubuntu/Debian
sudo apt install flatpak-builder

# Arch Linux
sudo pacman -S flatpak-builder

Build Process

  1. Clone the flatpak-builds repository:
git clone https://github.com/an-anime-team/flatpak-builds.git
cd flatpak-builds
  1. Build the Flatpak package:
flatpak-builder --user --install --force-clean build-dir moe.launcher.an-anime-game-launcher.yml
  1. Run the built application:
flatpak run moe.launcher.an-anime-game-launcher

Installation for Users

Users can install the Flatpak from Flathub or the An Anime Team repository:
# Add the Flathub repository (if not already added)
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Install the launcher
flatpak install flathub moe.launcher.an-anime-game-launcher

# Run the launcher
flatpak run moe.launcher.an-anime-game-launcher

Maintenance Guidelines

Updating the Package

  1. Monitor the main repository for new releases
  2. Update the manifest file with new version numbers and commit hashes
  3. Test the build locally before pushing
  4. Submit updates to the Flathub repository

Testing

Before releasing updates:
  • Test on multiple distributions (Fedora, Ubuntu, Arch-based)
  • Verify game launching functionality
  • Check for any runtime dependency issues
  • Test on Steam Deck if possible

Troubleshooting

Build Failures

If the build fails:
  1. Check that all dependencies are available
  2. Verify the manifest syntax is correct
  3. Ensure GTK4 and libadwaita versions match requirements
  4. Check the build logs for specific errors

Runtime Issues

For runtime problems:
  1. Check Flatpak permissions: flatpak info --show-permissions moe.launcher.an-anime-game-launcher
  2. Verify the sandbox has access to necessary directories
  3. Check logs: flatpak run --command=sh moe.launcher.an-anime-game-launcher

Contact

For Flatpak-specific issues or questions:

Build docs developers (and LLMs) love