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).
Gear Lever handles desktop integration and updates:
flatpak install flathub it.mijorus.gearleverDownload the latest AppImage for your CPU architecture from GitHub Releases, then open it with Gear Lever.
Download the latest AppImage for your CPU architecture from GitHub Releases, then:
chmod +x Adventure_Mods-<arch>.AppImage
./Adventure_Mods-<arch>.AppImageRunning without a subcommand launches the GUI. Pass a subcommand to use CLI mode.
| Command | Description |
|---|---|
detect |
Show detected game installs and inaccessible Steam libraries |
list-mods --game sadx|sa2 |
List available presets and mods for a game |
setup |
Install runtimes, mod manager, mods, and config files |
Setup flags
| Flag | Description |
|---|---|
--game sadx|sa2 |
Select the game |
--game-path /path |
Override Steam detection with an explicit install path |
--preset "Name" |
Use a named preset (SADX only) |
--all-mods |
Install all recommended mods |
--mods slug1,slug2 |
Select specific mods by slug |
--subtitle-language |
Set subtitle language (see below) |
--voice-language |
Set voice language: japanese or english |
--width, --height |
Override detected resolution |
Advanced flags
| Flag | Description |
|---|---|
--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
Tip
setup opens an interactive wizard when game, path, or mod selection is missing. Specify all options for a fully headless run.
Examples
./Adventure_Mods-<arch>.AppImage setup --game sadx --preset "DX Enhanced"
./Adventure_Mods-<arch>.AppImage setup --game sa2 --all-mods
./Adventure_Mods-<arch>.AppImage setup --game sa2 --mods sa2-render-fix,better-radar
./Adventure_Mods-<arch>.AppImage setup --game sa2 --subtitle-language japanese --voice-language english
./Adventure_Mods-<arch>.AppImage setup --game sadx --game-path "/path/to/SADX" --width 2560 --height 1440flatpak-builder --user --install build build-aux/io.github.astrovm.AdventureMods.Devel.jsonBuild in Podman with debian:13:
make appimageOutput: appimage-build/Adventure_Mods*.AppImage and .zsync.
The AppImage build is native-architecture: x86_64 hosts produce x86_64 AppImages, and ARM64/aarch64 hosts produce aarch64 AppImages. GitHub release builds publish both architectures.