mirror of https://github.com/kuhyx/steam-backlog-enforcer.git synced 2026-07-04 13:03:14 +02:00

History

Krzysztof kuhy Rudnicki 61096eded3 fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game - Guard enforce_allowed_game() and _guard_installed_games() against current_app_id=None so they never treat all games as unauthorized - Add early return in _enforce_loop_iteration when no game is assigned - Wrap State.load() in enforce loop with error handling for corrupt files - Switch all config/cache file writes to atomic (tmpfile + rename) - Add robust error handling to State.load() for corrupt JSON - Update tests for new behavior and add coverage for atomic writes		2026-03-25 19:19:52 +01:00
..
tests	fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game	2026-03-25 19:19:52 +01:00
__init__.py	feat: steam 100 percent extension	2026-03-02 20:29:32 +01:00
_enforce_loop.py	fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game	2026-03-25 19:19:52 +01:00
config.py	fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game	2026-03-25 19:19:52 +01:00
enforcer.py	fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game	2026-03-25 19:19:52 +01:00
game_install.py	fix(steam_backlog_enforcer): reload state in enforce loop, use steam:// protocol for installs	2026-03-17 21:48:33 +01:00
hltb.py	fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game	2026-03-25 19:19:52 +01:00
install.sh	feat: steam 100 percent extension	2026-03-02 20:29:32 +01:00
library_hider.py	Reduce per-file-ignores by fixing lint violations across codebase	2026-03-25 18:58:05 +01:00
main.py	fix: resolve all pre-commit hook failures after file splits	2026-03-18 22:20:05 +01:00
protondb.py	fix(steam_backlog_enforcer): prevent enforce daemon from deleting assigned game	2026-03-25 19:19:52 +01:00
README.md	feat: steam 100 percent extension	2026-03-02 20:29:32 +01:00
run.sh	feat: robotgo improvements in phone focus bluetooth and printer scripts	2026-03-09 18:34:15 +01:00
scanning.py	refactor: enforce 500-line limit on all Python source files	2026-03-17 22:47:42 +01:00
steam_api.py	feat: improvements in hosts bluetooth focus mode and backglog scripts	2026-03-11 20:47:03 +01:00
steam-backlog-enforcer.service	WIP: Enforce 500-line limit - split batch 1	2026-03-16 22:46:48 +01:00
store_blocker.py	feat: robotgo improvements in phone focus bluetooth and printer scripts	2026-03-09 18:34:15 +01:00

README.md

Steam Backlog Enforcer

Forces you to 100% complete one Steam game at a time before moving on.

Features

Achievement tracking: Picks the next game by shortest HLTB completionist time
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 if assigned game is complete
`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`	Remove store blocking
`reset`	Reset all state
`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:

Block Steam store in /etc/hosts
Uninstall all games except the assigned one
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