Skip to main content

​
Quickstart guide

This guide will help you install and run An Anime Game Launcher for the first time.
1

Install the launcher

Choose your installation method based on your Linux distribution.For other distributions, see the installation guide.
2

Launch the application

Run the launcher from your application menu or use the command line.
flatpak run moe.launcher.an-anime-game-launcher
On first run, the launcher will:
  • Create the launcher folder at ~/.local/share/anime-game-launcher
  • Create the cache folder at ~/.cache/anime-game-launcher
  • Auto-detect and set your system language
  • Display the first-run setup wizard
3

Complete the first-run setup

The first-run wizard will guide you through:
  1. Game installation path - Choose where to install the game
  2. Wine runner selection - Select or download a Wine compatibility layer
  3. DXVK configuration - Set up DirectX to Vulkan translation
  4. Language preferences - Confirm or change the launcher language
The launcher automatically detects your system language and sets it as the default. You can change this in settings later.
4

Download the game

After completing the setup:
  1. The launcher will check for game updates
  2. If the game is not installed, you’ll see a download button
  3. Click to start downloading the game files
  4. Wait for the download and installation to complete
The launcher uses a temporary directory for downloads. You can configure this location in settings.
5

Launch the game

Once the game is installed and ready:
  1. Click the “Launch” button in the main window
  2. The game will start using the configured Wine runner
  3. Enjoy your game!
You can also launch the game directly from the command line:
# Launch via launcher UI
anime-game-launcher --run-game

# Force launch game (skip preload checks)
anime-game-launcher --just-run-game

​
Next steps

Configure settings

Customize Wine runners, DXVK versions, FPS unlocker, and visual appearance

Manage sessions

Set up multiple game accounts using the session switching feature

Enable FPS unlocker

Unlock frame rates for better gaming performance

Join Discord

Get support and stay updated with the community

​
Troubleshooting

The launcher creates a .first-run file in ~/.local/share/anime-game-launcher/. If this file exists, the wizard will appear. Delete your launcher folder to trigger first-run again:
rm -rf ~/.local/share/anime-game-launcher
Enable debug logging to diagnose the issue:
anime-game-launcher --debug
Check the debug log at ~/.local/share/anime-game-launcher/debug.log
The launcher auto-detects language on first run. To change it:
  1. Open launcher settings
  2. Navigate to language preferences
  3. Select your preferred language
Or manually edit ~/.local/share/anime-game-launcher/config.json
If you encounter issues, check the debug log file at ~/.local/share/anime-game-launcher/debug.log for detailed error messages.

Build docs developers (and LLMs) love

Get started for freeTalk to us