A native Linux, command-line build of Overstrike, the mod manager for Insomniac's PC ports. It works with Marvel's Spider-Man 2, Spider-Man Remastered, Miles Morales, and Ratchet & Clank: Rift Apart.
It uses Overstrike's own installer code, so it installs .stage, .suit, .suit_style, .modular, .smpcmod and .script mods the same way the Windows app does. Only the Windows GUI is replaced, with a terminal interface. You don't need Wine, Proton, or the .NET Desktop Runtime.
This is an unofficial port and is not made by Tkachov. Report problems with this port here, not to Overstrike.
Download Overstrike-Linux-1.0-x86_64.AppImage, make it executable, and run it:
chmod +x Overstrike-Linux-1.0-x86_64.AppImage
./Overstrike-Linux-1.0-x86_64.AppImageYou can also right-click it in your file manager → Properties → allow executing, then double-click it. On the first start it finds your games in Steam. Then add mods (button, or drag files onto the list), tick the ones you want, and click Install mods.
The same file also runs the command-line tool: ./Overstrike-Linux-1.0-x86_64.AppImage cli list.
If it doesn't start and mentions FUSE, install fuse2/libfuse2 from your distro, or run it with --appimage-extract-and-run.
Download overstrike-cli-1.0-linux-x64.tar.gz and extract it:
mkdir -p ~/Applications
tar xzf overstrike-cli-1.0-linux-x64.tar.gz -C ~/Applications
~/Applications/overstrike-cli/overstrike-cli --versionThe prebuilt AppImage and binary work on distros with glibc 2.38 or newer. That includes Arch, CachyOS, Bazzite, SteamOS 3.6+, Fedora 39+, Ubuntu 24.04+ and Mint 22+. On older distros (Debian 12, Ubuntu 22.04), use the portable build with the .NET 10 runtime, or build it from source (see below).
Optional, so you can type overstrike-cli from anywhere:
mkdir -p ~/.local/bin && ln -s ~/Applications/overstrike-cli/overstrike-cli ~/.local/bin/- Back up your saves. If you remove a suit mod while your save still has that suit selected, the game can crash.
- Find the game and create a profile:
This reads your Steam libraries, including other drives, Flatpak Steam and Snap Steam.
overstrike-cli setup
- Add mods. You can add mod files directly, or
.zip/.7z/.rararchives with mods inside:overstrike-cli add ~/Downloads/cool_suit.suit ~/Downloads/some_mod.zip
- Check the mod list and load order. New mods are enabled by default:
overstrike-cli list
- Install the mods:
overstrike-cli install
- Start the game from Steam as usual. Regular mods need no launch options.
| Command | What it does |
|---|---|
setup |
Find installed games and create a profile for each |
add FILE... |
Copy mods into the Mods Library |
list |
Show mods in load order ([x] = enabled) |
enable N... / disable N... |
Toggle mods by number, by part of the name, or with all |
move N TO |
Change load order. Mods lower in the list win when two mods change the same files |
options N [M=O ...] |
Show or pick the options of a .modular mod, for example options 3 color=blue 2=1 |
install |
Apply all enabled mods. Run it again after any change |
uninstall |
Restore the original toc (vanilla game) |
scripts on [--commandline] / scripts off |
Toggle .script mod support |
language CODE |
Language for suit names (default us) |
reset-toc |
Delete toc, toc.BAK and the game .exe so Steam re-downloads clean copies |
profile list/create/use/delete |
Manage profiles, for example one per game or per mod set |
launch-options |
Show the Steam launch options needed for scripts |
where |
Show where the data folder, library and logs are |
Global options: -p NAME picks a profile, -y skips prompts, -v prints Overstrike's detailed log, and --home DIR sets the data folder.
Data is stored in ~/.local/share/overstrike-cli/ (Mods Library/, Profiles/, errors.log).
Script mods need Overstrike's scripts_proxy.dll. It's a Windows DLL that loads inside the game under Proton, so it is not included here.
- Copy
scripts_proxy.dllfrom the Windows Overstrike download (it's next toOverstrike.exe) into~/.local/share/overstrike-cli/. - Turn scripts on and install:
overstrike-cli scripts on --commandline overstrike-cli install
- In Steam, open Properties → General → Launch Options for the game and set:
Proton ignores DLLs in the game folder unless you tell it to load them. If you didn't use
WINEDLLOVERRIDES="winmm=n,b" %command%--commandline, add-scriptsat the end of that line.
Game updates replace toc. When you run install, overstrike-cli notices this and offers to use the new toc as the clean backup. Say yes (or pass --update-backup).
If mods still break the game after an update:
overstrike-cli reset-toc
# Steam: right-click the game → Properties → Installed Files → Verify integrity of game files
overstrike-cli installCopy your Windows Mods Library and Profiles folders into ~/.local/share/overstrike-cli/. Then edit the "path" line in each profile .json so it points at the Linux game folder. Mod order, enabled states, Suits Menu changes and script settings are all kept.
- There is no visual Suits Menu editor (reordering or hiding suits). Suits Menu changes already saved in a profile from Windows Overstrike are applied, and newly added suits show up in the game's menu as usual.
.modularoptions are picked by number or name withoptions, not in a visual wizard, so the option icons aren't shown.- Testing status: the full pipeline was tested against a synthetic Spider-Man 2 install, including
tocparsing and saving, GDeflate and LZ4 archive decompression, stage mods,.modularoptions, mods inside archives, uninstall and update detection. It has not yet been tested against the real game files. Suit and Suits Menu installs read real game data, so treat this as a beta and keep your saves backed up.
./build.sh # self-contained build → dist/overstrike-cli/
./build.sh --portable # needs the .NET 10 runtime to run
tests/run_tests.sh # end-to-end tests against a fake game install
appimage/build-appimage.sh # GUI + CLI AppImage → dist/ (needs: pip install PySide6-Essentials pyinstaller)The GUI (gui/overstrike_gui.py, Qt/PySide6) is a thin layer: every action runs overstrike-cli, and it reads state through overstrike-cli api ... (JSON). You can also run it straight from source with python3 gui/overstrike_gui.py after building the CLI.
You need git, make, gcc or clang, Python 3 (for the tests) and the .NET 10 SDK. build.sh clones Overstrike at a pinned commit, applies patches/, and builds NVIDIA's libdeflate fork for GDeflate support.
OverstrikeCLI/Program.cs: the new terminal front end, which replaces the WPF window.OverstrikeCLI/Compat/: small stand-ins for GUI-only types (banner images, the suits-menu tab's config loader), plus a two-methodIonic.Zlibshim built on .NET's own zlib.patches/0001-overstrike-linux-fixes.patch:tocstores archive paths Windows-style (d\mods\mod0). These are now resolved to real Linux paths, case-insensitively, when opening archives.- Stage mods and scripts zipped on Windows (with
\separators) are now handled on Linux. GDeflate.csdeclared libdeflate'ssize_tparameters as 32-bituint, and the native side wrote 8 bytes into a 4-byte variable. They are nownuint. Also fixed a decompressor that was never freed.ErrorLoggergot an optional console echo, used by-v.
GPLv3, the same as Overstrike. Overstrike is © Tkachov and contributors. This port bundles NVIDIA's libdeflate fork (MIT), SharpCompress (MIT), K4os.Compression.LZ4 (MIT) and Newtonsoft.Json (MIT).