Skip to content

Manage Tools

A core functionality of protondl is management of compatibility tools.

Managing tools is currently supported for the following launchers: Steam Lutris Heroic Bottles

List tools available for a specific launcher

Run the following commands to list all compatibility tools supported by a specific launcher. Replace <launcher id> with the ID of the launcher from list-launchers.

protondl list-tools <launcher id>

The commands returns a list of supported compatibility tools, a description, and a URL with more information about the specific tool. It also contains an ID for each compatibility tool, required by other commands.

Fetch available tool versions

Before installing a compatibility tool, you may want to list available versions. You need to provide either the tool name or the numeric tool ID from list-tools.

protondl list-versions <tool id or name>

# Optional pagination
protondl list-versions GE-Proton --count 30 --page 1

Installing a compatibility tool

To install a compatibility tool for a launcher, run the following command. You need to specify the launcher ID and compatibility tool ID or name, then the exact version string.

protondl install <launcher id> <tool id/name> <tool version name>

# Example
protondl install 1 GE-Proton GE-Proton10-10

List installed compatibility tools

If you want to see, which compatibility tools are installed for a specific launcher, run the following command:

protondl list-installed <launcher id>

Set global compatibility tool

Set the launcher's global/default compatibility tool using a tool name or the index from list-installed.

protondl set-global-tool <launcher id> <tool name or index>

# Examples
protondl set-global-tool 1 GE-Proton10-10
protondl set-global-tool 1 2

Global tool configuration is currently implemented for Steam launchers.