Package: protontricks
ProtontricksA wrapper that runs Winetricks commands for Proton enabled games among other useful features, requires Winetricks.This is a fork of the original project created by sirmentio. The original repository is available atSirmentio/protontricks.What is it?This is a wrapper script that allows you to easily run Winetricks commands for Steam Play/Proton games among other common Wine features, such as launching external Windows executables. This is often useful when a game requires closed-source runtime libraries or applications that are not included with Proton.RequirementsPython 3.6 or newerWinetricksSteamYAD (recommended)orZenity. Required for GUI.UsageProtontricks can be launched from desktop or using theprotontrickscommand.Command-lineThe basic command-line usage is as follows:# Find your game's App ID by searching for it
protontricks -s <GAME NAME>

# or by listing all games
protontricks -l

# Run winetricks for the game.
# Any parameters in <ACTIONS> are passed directly to Winetricks.
# Parameters specific to Protontricks need to be placed *before* <APPID>.
protontricks <APPID> <ACTIONS>

# Run a custom command within game's installation directory
protontricks -c <COMMAND> <APPID>

# Run the Protontricks GUI
protontricks --gui

# Launch a Windows executable using Protontricks
protontricks-launch <EXE>

# Launch a Windows executable for a specific Steam app using Protontricks
protontricks-launch --appid <APPID> <EXE>

# Print the Protontricks help message
protontricks --helpSince this is a wrapper, all commands that work for Winetricks will likely work for Protontricks as well.If you have a different Steam directory, you can export$STEAM_DIRto the directory where Steam is.If you'd like to use a local version of Winetricks, you can set$WINETRICKSto the location of your local winetricks installation.You can also set$PROTON_VERSIONto a specific Proton version manually. This is usually the name of the Proton installation without the revision version number. For example, if Steam displays the name asProton 5.0-3, useProton 5.0as the value for$PROTON_VERSION.Wanna see Protontricks in action?DesktopProtontricks comes with desktop integration, adding the Protontricks app shortcut and the ability to launch external Windows executables for Proton apps. To run an executable for a Proton app, selectProtontricks Launcherwhen opening a Windows executable (eg.EXE) in a file manager.TheProtontricksapp shortcut should be available automatically after installation. If not, you may need to runprotontricks-desktop-installin a terminal to enable this functionality.TroubleshootingFor common issues and solutions, seeTROUBLESHOOTING.md.InstallationYou can install Protontricks using a community package, Flatpak orpipx.pipcan also be used, but it is not recommended due to possible problems.If you're using a Steam Deck, Flatpak is the recommended option. Open theDiscoverapplication store in desktop mode and search forProtontricks.If you're using the Flatpak version of Steam, follow theFlatpak-specific installation instructionsinstead.Community packages (recommended)Community packages allow easier installation and updates using distro-specific package managers. They also take care of installing dependencies and desktop features out of the box, making themthe recommended option if available for your distribution.Community packages are maintained by community members and might be out-of-date compared to releases on PyPI.
Note that some distros such asDebian/Ubuntuoften have outdated packages for either ProtontricksorWinetricks.
If so, install the Flatpak version instead as outdated releases may fail to work properly.Flatpak (recommended)Protontricks is available on the Flathub app store:To use Protontricks as a command-line application, add shell aliases by running the following commands:echo "alias protontricks='flatpak run com.github.Matoking.protontricks'" >> ~/.bashrc
echo "alias protontricks-launch='flatpak run --command=protontricks-launch com.github.Matoking.protontricks'" >> ~/.bashrcYou will need to restart your terminal emulator for the aliases to take effect.The Flatpak installation is sandboxed and only has access to the Steam
installation directory by default.You will need to add filesystem permissions when
using additional Steam library locations or running external Windows
applications.Seeherefor instructions on changing the Flatpak permissions.pipxYou can use pipx to install the latest version on PyPI or the git repository for the current user. Installing Protontricks using pipx is recommended if a community package doesn't exist for your Linux distro.pipx does not install Winetricks and other dependencies out of the box.You can install Winetricks using theinstallation instructionsprovided by the Winetricks project.pipx requires Python 3.6 or newer.You will need to install pip, setuptools and virtualenv first.Install the correct packages depending on your distribution:Arch Linux:sudo pacman -S python-pip python-pipx python-setuptools python-virtualenvDebian-based (Ubuntu, Linux Mint):sudo apt install python3-pip python3-setuptools python3-venv pipxFedora:sudo dnf install python3-pip python3-setuptools python3-libs pipxGentoo:sudoemerge-avdev-python/pipdev-python/virtualenvdev-python/setuptools
python3-mpipinstall--userpipx
~/.local/bin/pipxensurepathClose and reopen your terminal. After that, you can install Protontricks.pipxinstallprotontricksTo enable desktop integration as well, run the following commandafterinstalling Protontricksprotontricks-desktop-installTo upgrade to the latest release:pipxupgradeprotontricksTo install the latest development version (requiresgit):pipxinstallgit+https://github.com/Matoking/protontricks.git# '--spec' is required for older versions of pipxpipxinstall--specgit+https://github.com/Matoking/protontricks.gitprotontrickspip (not recommended)You can use pip to install the latest version on PyPI or the git repository. This method should work in any system where Python 3 is available.Note that this installation method might cause conflicts with your distro's package manager. To prevent this, consider using the pipx method or a community package instead.You will need to install pip and setuptools first.Install the correct packages depending on your distribution:Arch Linux:sudo pacman -S python-pip python-setuptoolsDebian-based (Ubuntu, Linux Mint):sudo apt install python3-pip python3-setuptoolsFedora:sudo dnf install python3-pip python3-setuptoolsGentoo:sudo emerge -av dev-python/pip dev-python/setuptoolsTo install the latest release usingpip:sudopython3-mpipinstallprotontricksTo upgrade to the latest release:sudopython3-mpipinstall--upgradeprotontricksTo install Protontricks only for the current user:python3-mpipinstall--userprotontricksTo install the latest development version (requiresgit):sudopython3-mpipinstallgit+https://github.com/Matoking/protontricks.git