Manage Games (Library)

Managing games is currently supported for the following launchers: Steam

Basics

List installed games

Get a list of all installed games for a launcher using get_game_list(). This returns a sequence of Game objects containing metadata about each game, including the game ID, name, install path, and assigned compatibility tool.

from protondl.launchers.steam import SteamLauncher

launcher = SteamLauncher.discover()[0]
games = launcher.get_game_list()

for game in games:
    print(f"{game.id}: {game.name} ({game.compat_tool_name})")

Set compatibility tool for a specific game

Set a specific compatibility tool for one or more games using set_games_tools(). This method accepts a mapping of games to tool names. Pass None to use the global compatibility tool.

from protondl.launchers.steam import SteamLauncher

launcher = SteamLauncher.discover()[0]
games = launcher.get_game_list()

# Find a specific game and change its tool
game_to_update = next(g for g in games if g.name == "My Game")

# Set a specific tool
launcher.set_games_tools({game_to_update: "Proton-8.0"})

# Or use the global tool
launcher.set_games_tools({game_to_update: None})

Read Steam Deck compatibility metadata

SteamGame objects expose get_steamdeck_compatibility() to return the recommended runtime and compatibility category.

from protondl.launchers.steam import SteamDeckCompatType, SteamLauncher

launcher = SteamLauncher.discover()[0]

for game in launcher.get_game_list():
    recommended_runtime, status = game.get_steamdeck_compatibility()
    if status == SteamDeckCompatType.VERIFIED:
        print(f"{game.name} is VERIFIED (recommended runtime: {recommended_runtime or 'none'})")

Helper functions

Batch update games

Update the compatibility tool for multiple games at once using batch_update_games_tools(). You can match games by an exact tool name (using a CompatTool instance) or by a partial string match.

from protondl.launchers.steam import SteamLauncher
from protondl.util.helpers import batch_update_games_tools
from protondl.core.models import CompatTool, CompatToolType
from pathlib import Path

launcher = SteamLauncher.discover()[0]

# Get the new tool to assign
new_tool = CompatTool("Proton-9.0", CompatToolType.PROTON, Path("/path/to/tool"))

# Update all games using tools with "GE-Proton" in the name
count = batch_update_games_tools(launcher, "GE-Proton", new_tool)
print(f"Updated {count} games")

# Or update games using an exact tool
old_tool = CompatTool("Proton-8.0", CompatToolType.PROTON, Path("/path/to/tool"))
count = batch_update_games_tools(launcher, old_tool, new_tool)
print(f"Updated {count} games")