Skip to content

Quick Guide

Alert 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: License Change

  • Info: Games no longer seem to be detected by WeMod. If anyone has info on how WeMod finds games, please open a new issue. If you have no idea, please don’t open a bug report — we can’t fix this if we don’t know how. You will have to add the game manually right now.

  1. Python python-venv (or python3-venv or venv or virtualenv; use the 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 online for install Tkinter for YOURDISTRO.
    • Ubuntu/Debian: sudo apt install python3-tk
    • Arch Linux: sudo pacman -S tk.
    • Fedora: sudo dnf install python3-tkinter
    • openSUSE Tumbleweed: sudo zypper in python313 THEN sudo zypper install python3-tk
  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, the 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/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).
    2. Run chmod -R ug+x wemod-launcher. NOTE: To use this tool with the Flatpak version of Steam (not recommended), continue here.
  5. In your Steam Library, open the game settings with which to run WeMod. 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 (or better), go to step 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): Log in to your WeMod account.
  11. Select the game you’re running from the library, then click 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 Launcher features Like: Check how to use external launchers (use the WeMod Launcher outside of Steam) OR: Check out how to edit the config