WeMod Launcher (Wemod for Linux)
The WeMod Launcher is currently on version 1.544.
The 1.x line is in bugfix-only mode. It is no longer getting new features, only bug fixes.
Active development is happening in the rewrite (see the Rework Project below).
Quick Jump
DISCLAIMER
This project is NOT affiliated with, funded by, or paid by WeMod.
The work done here is purely from the contributors who donate their time and effort.
WeMod (the company) makes WeMod (the mod tool).
We (wemod-launcher) enable you to run it on Linux (and by extension, the Steam Deck).
Support & Contributions
If this tool helps you, please consider one or more of the following:
- Star the project to show support and visibility.
- Read the Contribution Policy to learn what the project strives for, what a good PR looks like, and how AI-assisted contributions are handled.
- Contribute code we are actively looking for developers to improve the current launcher, to help with the modern rework in areas like GUI, Wine handling, config logic, and Python code structure, and to improve Flatpak compatibility (see Rework Project below).
- Help with docs and issues — document known issues, write new guides, or help others by referencing existing solutions. See the Wiki or file / answer an Issue.
- Financial and regular support for developers:
For more help:
Rework Project
The project has a rework, currently on the /rewrite/v2 branch (NOT USEABLE).
This rework focuses on modular design, better maintainability, improved UX, and modern code practices.
We are calling for contributors to assist with:
- Python developers: Help refactor or implement core modules (GUI, Wine prefix handling, config, launch logic).
- Testers: Provide feedback, test new code, and report issues across different distros and devices (especially Steam Deck).
- Wiki writers & documenters: Help write guides and technical documentation for the rework.
Want to get involved?
Quick Guide
This guide only includes the most relevant info and might not be enough to run WeMod;
in which case, check out the Full Guide OR the video tutorial by Marvin1099.
-
Optional: If you have access to another PC and wish to control the Steam Deck remotely,
consider using RustDesk for easier setup (the .AppImage is easiest).
-
Info: License Change to AGPL3
-
Info: Games no longer seem to be detected by Wemod. If anyone has info on how Wemod finds games, please make a new issue. If you have no idea, please don’t make a bug report.
We can’t fix this if we don’t know how. You will have to add the game manually for now.
- Python
python-venv (or python3-venv or venv or virtualenv; use first one found)
and Tk need to be installed.
Tk / Tkinter may be under a different name in your distribution’s repos.
If none of the below options work (or your distro is missing), search on the internet for install Tkinter for YOURDISTRO.
- Ubuntu/Debian:
sudo apt install python3-tk
- Arch Linux:
sudo pacman -S tk.
- Fedora:
sudo dnf install python3-tkinter
- Install GE-Proton, which is necessary to run the game and WeMod with. Using Valve’s own Proton seems to work, but using GE-Proton is recommended:
- Search for and install
ProtonUp-QT via your distro’s software center. If using Flatpak, command is: flatpak install net.davidotek.pupgui2.
- Download the latest GE-Proton in
ProtonUp-QT
- Restart Steam/SteamOS.
- In a terminal session (Konsole if using KDE Plasma):
- Change directory to a location of your choosing, then run
git clone https://github.com/DeckCheatz/wemod-launcher.
Make note of the directory obtained with readlink -f wemod-launcher (which will be labeled {path/to/wemod-launcher} for the rest of this guide).
- Run
chmod -R ug+x wemod-launcher.
NOTE: To use this tool with the Flatpak version of Steam (not recommended), continue here.
- In your Steam Library, open the game settings with which to run WeMod with. Make sure you ran the game once before doing this!
- In the
Compatibility tab, change the Proton version to the one picked in Step 2, or otherwise to the latest numbered Proton (e.g. Proton-9.0).
- Under
Launch Options, input {path/to/wemod-launcher}/wemod %command%.
- Start the game.
- Select “no” to the “copy prefix question” if it appears and says
might work.
If it mentions likely works (or better) go to step 8 (accept all).
- Select download.
- Select Yes/Ok until no more windows appear.
All rundll32.exe errors can safely be ignored (by clicking no).
WeMod should start with the game.
- (Only done once): Login to your WeMod account.
- Select the game you’re running from the library, then click the Play to start the WeMod engine.
- You may now set or switch mods. Closing the WeMod window will keep it running in the background.
wemod-launcher will automatically update if you installed it using step 4.
But: This will only work if you have launcher version 1.092 or older.
Optionally: Check out tutorials on how to use specific WeMod Launcher features
Like: Check how to Use External Launchers (Use The WeMod Launcher outside of Steam)
OR: Check out how to Edit The Config
Common Issues
Dot Net Error
If you see a .net error in Wemod that means your prefix is messed up.
- After you close the game the troubleshooter should come up (close ingame not from steam).
- There select “delete prefix” or something like that.
- Rerun the game, and when it asks you to use an already installed prefix, with some version, say no.
- Then click Download.
- After you managed to find and click download, a tested prefix will be downloaded.
- After that it should work.
Additional
Video Tutorial: WeMod-launcher Setup Tutorial by Marvin1099
Guide was created by Trippin and updated by Marvin1099.
The WeMod Launcher was created by DaniAsh551, with the current maintainer Marvin1099.
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)
评论