WeMod Launcher (Wemod for Linux)

The WeMod Launcher is currently on version 1.514.

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

If this tool helps you, please consider one or more of the following:

• Star the project.
• Code contributions. We could use some more developers!
• Support the original developer DaniAsh551 on: Buymeacoffee, Patreon, PayPal.
• Support the current developer Marvin1099 on: Patreon, Tipeeestream
• Suport the developer JohnHamwi on: Github

Code contributions would be greatly appreciated.
You are also welcome to report your findings/suggestions by filing an Issue.
For more info on suggestions, check out the Wiki Suggestion info.

Check the Wiki Changelog or the Wiki features section for changes.

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 .flatpak is easiest).

• Info: The Proposal to change the License of the wemod launcher from MIT to AGLP3
  was accepted by contributions and voters (info here) and was integrated into the project on 1st December 2024.

1. Python virtualenv (or venv) and Tk need to be installed.
   venv should already be integrated in your python3 installation. 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
2. 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:
   1. Search for and install ProtonUp-QT via your distro's software center. If using Flatpak, command is: flatpak install net.davidotek.pupgui2.
   2. Download the latest GE-Proton in ProtonUp-QT
3. Restart Steam/SteamOS.
4. In a terminal session (Konsole if using KDE Plasma):
   1. Change directory to a location of your choosing, then run git clone https://github.com/DaniAsh551/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).
   2. Run chmod -R ug+x wemod-launcher.
      NOTE: To use this tool with the Flatpak version of Steam (not recomended), continue here.
5. In your Steam Library, open the game settings with which to run WeMod with. Make sure you ran the game once before doing this!
   1. 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).
   2. Under Launch Options, input {path/to/wemod-launcher}/wemod %command%.
6. Start the game.
7. Select "no" to the copy prefix question if it appears and says might work.
   If it mentions likely works go to 9 (accept all).
8. Select download.
9. 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.
10. (Only done once): Login to your WeMod account.
11. Select the game you're running from the library, then click the Play to start the WeMod engine.
12. 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 5.
But: This will only work if you have launcher version 1.092 or older.

Optionally: Check out tutorials on how to use specific WeMod Laucher features
Like: Check how to Use External Launchers (Use The WeMod Launcher outside of Steam)
OR: Check out how to Edit The Config

Additional

Video Tutorial: WeMod-launcher Setup Tutorial by Marvin1099
Guide was written by Trippin and updated by Marvin1099.
WeMod Linux is developed by DaniAsh551 with recent support by Marvin1099.
If you find this guide to be helpful, we encourage you to star the project.