Go to file
Krzysztof kuhy Rudnicki 9cb0ebbed6 Install params icons and result marks in UI
The install dialog paints its own icons for the new target, dry-run
and Valve-Proton params. A job result paints a dry-run mark, or a
game-running mark when the fast installer (it closes Steam) was
skipped because a game was running (InstallResultData).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWZCxnNWLtpVwFLVk9w
2026-11-22 20:47:22 +01:00
.github/workflows Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
docs/explanations feat(enforcer): raise manual pick cap from 2 to 3 concurrent games 2026-07-23 18:05:29 +02:00
pacman-hooks Add a daily gaming-time budget with a binary-level cutoff 2026-08-04 20:00:08 +02:00
scripts Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
steam_backlog_enforcer Install by target, dry run and Valve Proton 2026-11-22 20:46:31 +01:00
steam_installer Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
web Install params icons and result marks in UI 2026-11-22 20:47:22 +01:00
.gitignore Add CI-mirror pre-push gate + requirements-sync check 2026-07-11 17:47:14 +02:00
.gitleaksignore Ignore fake test key fingerprints 2026-11-22 20:31:08 +01:00
.mcp.json Add MCP server exposing the enforcer to Claude Code 2026-07-10 21:05:17 +02:00
.pre-commit-config.yaml Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
AGENTS.md Split ci-mirror gate into <60 s steps 2026-11-11 16:29:08 +01:00
CLAUDE.md Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
DOCS-ctl-socket.md Verify store unblock/re-block; file failures 2026-11-22 17:07:29 +01:00
DOCS-icon-words.md Register every UI icon word in the registry 2026-11-16 10:50:45 +01:00
DOCS-steam-installer.md Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
DOCS-web-control-api.md Install by target, dry run and Valve Proton 2026-11-22 20:46:31 +01:00
DOCS-web-install.md Install by target, dry run and Valve Proton 2026-11-22 20:46:31 +01:00
install.sh Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
LICENSE chore: add MIT LICENSE 2026-10-11 18:12:51 +02:00
pyproject.toml Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
README.md Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
requirements.txt Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
run.sh web control UI: all 24 commands in React, ctl.sock daemon, jobs, library browser; earned_time 0.7.0 2026-10-10 16:07:42 +02:00
steam-backlog-enforcer-web.service Stop the web UI serving numbers the enforcer is not applying 2026-08-29 23:39:40 +02:00
steam-backlog-enforcer.desktop web control UI: all 24 commands in React, ctl.sock daemon, jobs, library browser; earned_time 0.7.0 2026-10-10 16:07:42 +02:00
steam-backlog-enforcer.service web control UI: all 24 commands in React, ctl.sock daemon, jobs, library browser; earned_time 0.7.0 2026-10-10 16:07:42 +02:00

Steam Backlog Enforcer

This repo is also an alternative Steam frontend: it installs games faster than the Steam client (steam_installer, see DOCS-steam-installer.md).

Forces you to play one Steam game at a time: earn at least one new achievement in the assigned game before moving on to the next.

Requiring 100% completion kept you locked onto one game for weeks, which proved ineffective. A game released after one new achievement stays in the backlog (it is not counted as finished) and comes round again later.

Features

  • Achievement tracking: Picks the least-recently-assigned game next, then the shortest HLTB completionist time; a released game sits out a 7-day cooldown
  • Store blocking: Blocks store.steampowered.com via /etc/hosts
  • Game uninstalling: Removes all installed games except the assigned one
  • Process enforcement: Kills unauthorized game processes
  • Tampering detection: Detects achievement unlocks on non-assigned games
  • HLTB integration: Estimates completion time with persistent cache

Setup

python -m python_pkg.steam_backlog_enforcer.main setup

Commands

Command Description
scan Scan library, fetch HLTB data, assign game
check Check assigned game for a new achievement
status Show current assignment and blocking
list List incomplete games from snapshot
skip Skip the currently assigned game
enforce Run enforcer (block, uninstall, kill)
unblock [minutes] Unblock the store for a window (default 15, max 30); the daemon keeps it open and re-blocks after
buy-dlc Same 15-minute store window, to buy a game or DLC
reset Reset all state
total-block-research --until T Root. One window per total block, up to its end, extendable once: Steam and the store open, only Librarian may be played; the daemon re-applies the full block at T and keeps ~/.local/share/Steam
installed List currently installed Steam games
uninstall Interactively uninstall non-assigned games
setup First-time configuration

Enforce mode

sudo python -m python_pkg.steam_backlog_enforcer.main enforce

This will:

  1. Block Steam store in /etc/hosts
  2. Uninstall all games except the assigned one
  3. Continuously kill any unauthorized game processes

Game Uninstall

Directly removes appmanifest files and game directories from ~/.local/share/Steam/steamapps/. Preserves Proton versions and Steam Linux Runtime.

python -m python_pkg.steam_backlog_enforcer.main uninstall

MCP server (Claude Code integration)

The enforcer exposes an MCP server (steam_backlog_enforcer._mcp) so Claude Code and its subagents can query the backlog and drive it through typed tools.

  • Read tools: get_dataset, get_status, get_stats, list_backlog.
  • Gated write tools: pick_manual, block_gaming — each defaults to a dry-run preview; pass confirm=true to actually apply. These write tools must never be added to a permission allowlist (a subagent could otherwise bypass the human confirmation).

The mcp SDK is an optional dependency (pip install -e '.[mcp]'), kept out of the CLI/systemd system-python path. One-time setup of the dedicated venv that Claude Code spawns:

./scripts/setup_mcp.sh

Registration lives in the checked-in .mcp.json (project scope). Restart Claude Code in this repo and approve the project MCP-server prompt for it to load. Verify with claude mcp list.

Steam game installer

steam_installer (merged in from steam-game-installer) downloads an owned game with depotdownloader and makes Steam accept it as installed. The daemon runs it as python3 -m steam_installer.cli; by hand use steam_installer/run.sh <appid|url|name>. Dependencies: steam_installer/install_deps.sh (run by install.sh). Details in DOCS-steam-installer.md.