The easiest way to mod Sonic Adventure DX and Sonic Adventure 2 on Linux. Finds your Steam installs, downloads community mods, and handles mod managers, runtimes, resolution, load order, and language settings so you can play right away.
- Detects SADX and SA2 across all Steam library folders
- Includes 29 SADX mods and 12 SA2 mods
- Provides SADX presets: DX Enhanced and Dreamcast Restoration
- Installs mod managers, mods, and dependencies in one step
- Configures native resolution, window mode, and optimal settings
- Saves subtitle and voice language selection per game
- Steam with Sonic Adventure DX (app 71250) and/or Sonic Adventure 2 (app 213610)
- Force Proton 10.0 for each game under Properties → Compatibility
Proton 11 and tools based on it (Hotfix, Experimental, many custom builds such as CachyOS) currently cannot keep SA Mod Manager running.
Flatpak (recommended)
Install Adventure Mods, or use the terminal:
flatpak install https://flatpak.4st.li/io.github.astrovm.AdventureMods.flatpakrefAfter installing, open Adventure Mods from your application menu and follow the setup wizard.
Update it later through your software manager or with:
flatpak updateOther options (AppImage)
AppImage with Gear Lever — Install Gear Lever, or use the terminal:
flatpak install https://dl.flathub.org/repo/appstream/it.mijorus.gearlever.flatpakrefGear Lever handles desktop integration and updates.
Download the latest AppImage from GitHub Releases and open it with Gear Lever.
AppImage manually
chmod +x AdventureMods-<arch>.AppImage
./AdventureMods-<arch>.AppImageRunning without a subcommand launches the GUI. Pass a subcommand for CLI mode.
The graphical app is recommended for most users. From a terminal, the usual entry point is the interactive setup wizard:
flatpak run io.github.astrovm.AdventureMods setupIt walks through game selection, mods, and install steps. Omit game or mod flags to stay interactive; pass them only when you want a fully non-interactive run.
Other commands
| Command | Description |
|---|---|
detect |
Show detected game installs and inaccessible Steam libraries |
list-mods --game sadx|sa2 |
List available presets and mods for a game |
flatpak run io.github.astrovm.AdventureMods detect
flatpak run io.github.astrovm.AdventureMods list-mods --game sadx
flatpak run io.github.astrovm.AdventureMods --helpNon-interactive setup options
Use these with setup for scripting. When game, path, or mod selection is omitted, setup stays interactive.
| Flag | Description |
|---|---|
--game sadx|sa2 |
Select the game |
--game-path /path |
Override Steam detection |
--preset "Name" |
Named preset (SADX only) |
--all-mods |
Install all recommended mods |
--mods slug1,slug2 |
Install specific mods by slug |
--subtitle-language |
Select subtitles |
--voice-language |
Select japanese or english voices |
--width, --height |
Override the detected resolution |
--libraryfolders-vdf /path |
Use a specific libraryfolders.vdf file |
--steam-library /path |
Add an extra Steam library root (repeatable) |
Subtitle languages:
- SADX:
japanese,english,french,spanish,german - SA2:
english,german,spanish,french,italian,japanese
flatpak run io.github.astrovm.AdventureMods setup --game sadx --preset "DX Enhanced"
flatpak run io.github.astrovm.AdventureMods setup --helpFlatpak (Devel manifest, installs for the current user)
make flatpakProduction manifest: make flatpak FLATPAK_MANIFEST=build-aux/io.github.astrovm.AdventureMods.json
AppImage (Podman + debian:13)
make appimageOutput: appimage-build/AdventureMods-<arch>.AppImage and .zsync. Builds match the host
architecture (x86_64 or aarch64). GitHub Releases publish both.