Skip to main content

Python module for applying fixes at runtime for games not supported by Steam Proton

Project description


Build Status


- There is a regression in wine's MSI installer affecting Proton 3.16. 
- If you are using protonfixes to play games that require dotnet tricks,
- you can temporarily switch to Proton 3.7 to get protonfixes to install 
- dotnet tricks for that game. Alternatively you can install a compiled
- Proton 3.16 with a the patched version of wine available on my Proton
- repo at
- On Proton 3.16 some games may treat the XBox and Steam Controller trigger 
- axis as a joystick input causing controls to drift upwards and to the 
- left (this can be observed by running '/tmp/proton_$USER/run control' and 
- looking at the Test Joystick tab under Game Controllers.

A module for applying fixes at runtime to unsupported games with Steam Proton without changing game installation files. The idea is to include seperate fixes that are only loaded when a game matching that ID is run. This should keep the individual game fixes from affecting any other games. Applying the fixes at runtime should also them to persist after game updates.

Current fixes include:

  • Age Of Empire 3: Complete Collection
  • Age of Empires 2 HD Edition
  • Age of Mythology: Extended Edition
  • Battlefield: Bad Company 2
  • BioShock 2 Remastered
  • Call of Duty (2003)
  • Chronophantasma Extend
  • Civilization 4 (Beyond the Sword)
  • Doom 2016
  • EVE Online
  • Forts
  • Game fix for Fallout 2
  • Game fix for Fallout: A Post Nuclear Role Playing Game
  • Grand Theft Auto V
  • Killer is Dead at Launch
  • Little Nightmares
  • Oddworld: Abe's Oddysee
  • Oddworld: Munch's Oddysee
  • Order of Battle: World War II
  • STAR WARS Jedi Knight II - Jedi Outcast
  • STAR WARS Jedi Knight - Jedi Academy
  • Styx: Master of Shadows
  • SUGURI 2
  • Tesla Effect
  • The Evil Within
  • Titan Quest Anniversary Edition
  • Tomb Raider I
  • You Need a Budget 4

Current utilities available:

  • util.protontricks('verb')
    • installs a winetricks verb
  • util.use_win32_prefix()
    • creates and uses a win32 (32bit) wineprefix
  • util.replace_command('original', 'replacement')
    • replaces text in the game's launch command
  • util.append_argument('argument')
    • adds an argument to the game's launch command
  • util.protonprefix()
    • returns the path of the current wineprefix used by Proton
  • util.set_environment('VARIABLE', 'value')
    • sets an environment variable
  • util.winedll_override('dllname', 'x')
    • override dllname where x is n for native, b for builtin, or '' for disable
  • winedll_override shortcuts:
    • util.disable_dxvk()
    • util.disable_esync()
    • util.disable_d3d10()
    • util.disable_d3d11()
    • util.disable_nvapi()
  • util.get_game_install_path()
    • returns the path to the current game
  • util.create_dosbox_conf('filename', conf_dict)
    • creates a config file filename with the dict conf_dict (needs to have '-conf' and 'filename' added with util.append_argument for dosbox use config)


Optional Requirements


If you want to be able to use fixes with winetricks it must be installed and be in your $PATH. Fixes that do not use winetricks will still work without winetricks being installed.

Winetricks can take a long time to run


If you want to use a win32 (32bit) prefix, you need to have wine installed and be in your $PATH. Currently creating a 32bit prefix with Proton wine doesn't work because the wineserver is already running by the time is loaded.

Progress Dialog / Splashscreen

If Steam is in big picture mode, protontricks will try to launch a similarly themed splash dialog using cefpython (pictured above). Otherwise it will try to use zenity to display a progress bar. If Steam is not in big picture mode, it will default to zenity. The progress bar or splashscreen can help let you know that protonfixes is running a long task, for example installing dotnet35.

For the progress dialog to work, you need to have zenity installed on your system, the steam-runtime version is broken. It can probably be installed using your distro's package manager.

For the big screen splashscreen to work, you need to have cefpython3 installed. It can be installed with pip using sudo pip install cefpython3.

Install from PIP

Make sure to use the version of pip that matches the version of Python that Proton is running. Proton should be running on python3. If you are unsure, try installing with both pip3 and pip2 in the below commands.

# sudo pip3 install protonfixes

Upgrade from PIP

# sudo pip3 install protonfixes --upgrade

Install using setuptools

# sudo python3 install

Add to

In the steamapps/common/Proton* directory, add the following line to the bottom of the file:

import protonfixes

If there is no file, make a copy of the file included with Proton.


Proton output can be seen in either /tmp/dumps/${USER}_stdout.txt or the terminal you started Steam from. To add additional protonfixes debugging information, add the following line above import protonfixes:

from protonfixes import debug

This will add information like this:

ProtonFixes[27351] DEBUG: ---- begin protontricks debug info ----
ProtonFixes[27351] DEBUG: Proton Python Version:
ProtonFixes[27351] DEBUG: /usr/bin/python3
ProtonFixes[27351] DEBUG: 3.7.0 (default, Jul 15 2018, 10:44:58)
[GCC 8.1.1 20180531]
ProtonFixes[27351] DEBUG: ---------------------------------------

Although the environment variables are dumped, the sensitive variables like SteamUser and SteamAppUser are filtered out.

Writing Game Fixes

Game fixes are written in python and are named by the Steam game ID with the extension .py. For example, the file will be loaded when the game FINAL FANTASY IX is run. Gamefixes can be added to the ~/.config/protonfixes/localfixes/ directory. Here are some things to consider when writing fixes:

  • Only import libraries that are part of the Python standard library for portability.
  • Use docstrings and comment thoroughly. There will likely be people without python experience making game fixes and good commented examples will help
  • Do not use any hard-coded paths, Steam may not always be installed in the same location.
  • Check your gamefix with pylint. You can safely disable warning C0103, modules named by Steam ID will never conform to snake_case naming style.


When testing, local fixes can be added to ~/.config/protonfixes/localfixes/. They should be imported the same way as an included fix would be. For example, ~/.config/protonfixes/localfixes/ would be loaded for FFIX. Please feel free to submit working gamefixes to improve the project.

Example game fixes - Changing the executable launched and setting an environment variable

""" Game fix for FINAL FANTASY IX
#pylint: disable=C0103

from protonfixes import util
from protonfixes.logger import log

def main():
    """ Changes the proton argument from the launcher to the game

    log('Applying fixes for FINAL FANTASY IX')

    # Fix crackling audio
    util.set_environment('PULSE_LATENCY_MSEC', '60')

    # Replace launcher with game exe in proton arguments
    util.replace_command('FF9_Launcher.exe', 'x64/FF9.exe') - Running a winetricks verb

""" Game fix for Forts
#pylint: disable=C0103

from protonfixes import util
from protonfixes.logger import log

def main():
    """ Uses winetricks to install the ole32 verb

    log('Applying fixes for Forts')

    util.protontricks('ole32') - Example using a win32 prefix

Oddworld doesn't actually require a win32 prefix or dotnet35, but I used it for testing since it's 32bit

from protonfixes import util
from protonfixes.logger import log

def main():
    """ Adds -interline to arguments, uses a win32 prefix, and installs dotnet35

    log('Applying fixes for Oddworld: Abe\'s Oddysee')

    # Adding -interline fixes slow video but adds scanlines

    log('Using a win32 prefix')

    # Make sure any winetricks are run after changing to a win32 prefix


Pull requests are welcome! If you're not comfortable doing pull requests, send your fixes to me by any other means and you will be credited in the comments.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

protonfixes-1.0.16.tar.gz (24.3 kB view hashes)

Uploaded source

Built Distribution

protonfixes-1.0.16-py3-none-any.whl (34.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page