Add Steam games launcher mode

Add new UI mode triggered by comma (,) that shows installed Steam games
with fuzzy search. Games are launched via steam://rungameid/ protocol.

Features:
- SteamScanner service parses appmanifest_*.acf files
- New -l/--steam-library flag for custom Steam library path
- Spanish localization for new strings

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: ogomez92

CLAUDE.md

@@ -10,6 +10,7 @@ Launchtype is a Windows application launcher inspired by macOS's Launchbar. It p
 - Command launcher with fuzzy search
 - Text snippets system
 - Clipboard history (up to 50 items)
+- Steam games launcher (scans installed games)
 - Keyboard-driven interface designed for screen reader accessibility
 - Audio feedback for UI interactions
 
@@ -49,6 +50,7 @@ uv run python src/main.py
 # -m, --start-minimized: Start application minimized
 # -s, --snippets-on-invoke: Start in snippets mode instead of commands
 # -c, --commands [file]: Specify custom commands file (default: commands.json)
+# -l, --steam-library [path]: Specify custom Steam library path (default: C:\Program Files (x86)\Steam\steamapps)
 ```
 
 ## Architecture
@@ -75,10 +77,11 @@ The entry point is `src/main.py` which:
 
 **UIManager** (`src/managers/ui_manager.py`)
 - Manages the wxPython UI frame and controls
-- Handles three UI modes (UIMode enum):
+- Handles four UI modes (UIMode enum):
   - COMMANDS (default): Shows saved commands
   - SNIPPETS (activated by "-"): Shows text snippets
   - CLIPBOARD (activated by "?"): Shows clipboard history
+  - STEAM (activated by ","): Shows installed Steam games
 - Toggle back to COMMANDS mode with "."
 - Provides dialogs for adding/editing commands and snippets
 
@@ -95,6 +98,10 @@ The entry point is `src/main.py` which:
 - `clipboard_history.py`: Background thread monitoring clipboard with pyperclip
   - Polls every 0.1s, maintains up to 50 items
   - Persists to `clipboard_history.json`
+- `steam_scanner.py`: Scans Steam library for installed games
+  - Parses `appmanifest_*.acf` files in steamapps folder
+  - Extracts game names and appids
+  - Launches games via `steam://rungameid/APPID` URL
 
 ### Data Model
 
@@ -129,6 +136,17 @@ The entry point is `src/main.py` which:
 }
 ```
 
+**Steam game structure** (in-memory):
+```python
+{
+    "name": "game name",       # lowercase for matching
+    "shortcut": "",            # not used for Steam games
+    "id": "uuid",
+    "appid": "620",            # Steam app ID
+    "type": "steam"
+}
+```
+
 ### Search Algorithm
 Commands and clipboard items use difflib.get_close_matches with 0.6 cutoff. Shortcuts provide exact match priority (triggers "match" sound vs "type" sound).
 
@@ -138,7 +156,7 @@ SoundPlayer (`src/helpers/sound_player.py`) provides audio cues:
 - "show"/"hide": Window visibility toggle
 - "match": Exact shortcut match
 - "type": Search results update
-- "run": Command execution
+- "run": Command execution or Steam game launch
 - "copy": Snippet/clipboard item copied
 
 ### Accessibility

locale/es/LC_MESSAGES/launchtype.mo

@@ -30,6 +30,10 @@ msgstr "Arranca la aplicación minimizada"
 msgid "specify commands file to use, default is commands.json"
 msgstr "especifica el archivo de comandos a usar (por defecto commands.json)"
 
+#: src/managers/command_line_parameters.py:32
+msgid "specify custom Steam library path"
+msgstr "especifica la ruta personalizada de la biblioteca de Steam"
+
 #: src/managers/ui_manager.py:24
 msgid "Input Field"
 msgstr "Consola"
@@ -82,6 +86,10 @@ msgstr "Modo historial de portapapeles"
 msgid "commands mode"
 msgstr "modo comandos"
 
+#: src/managers/ui_manager.py:195
+msgid "Steam games mode"
+msgstr "modo juegos de Steam"
+
 #: src/managers/ui_manager.py:221
 msgid "{}, {} search results shown, use tab and down arrow to access more results"
 msgstr "{}, {} resultados de búsqueda mostrados, usa tab y flecha abajo para acceder a más resultados"

locale/es/LC_MESSAGES/launchtype.po

@@ -3,4 +3,5 @@
 class UIMode(Enum):
     COMMANDS = 0
     SNIPPETS = 1
-    CLIPBOARD = 2
+    CLIPBOARD = 2
+    STEAM = 3

src/enums/ui_mode.py

@@ -10,7 +10,7 @@
 language_handler.initialize()
 
 command_line = get_command_line_parameters()
-dataManager = DataManager(command_line.commands)
+dataManager = DataManager(command_line.commands, command_line.steam_library)
 
 SpeechService().initialize()
 

src/main.py

@@ -26,6 +26,14 @@ def get_command_line_parameters():
         default="commands.json",
     )
 
+    parser.add_argument(
+        "-l",
+        "--steam-library",
+        help=_("specify custom Steam library path"),
+        action="store",
+        default=None,
+    )
+
     args = parser.parse_args()
 
     return args

src/managers/command_line_parameters.py

@@ -1,6 +1,7 @@
 import json
 from os.path import exists
 from services.clipboard_history import ClipboardHistory
+from services.steam_scanner import SteamScanner
 from helpers.plist_helper import parse_apple_snippets
 from helpers.search_utility import fuzzy_search, check_exact_shortcut_match
 from enums.ui_mode import UIMode
@@ -15,8 +16,9 @@ class DataManager:
     clipboard_history = ClipboardHistory()
     snippets = []
 
-    def __init__(self, commands_file):
+    def __init__(self, commands_file, steam_library_path=None):
         self.commands_file = commands_file
+        self.steam_scanner = SteamScanner(steam_library_path)
 
         if not exists("snippets"):
             import os
@@ -66,6 +68,9 @@ def get_data_list_items(self, search_string="", mode=UIMode.COMMANDS):
         if mode == UIMode.CLIPBOARD:
             return self.get_history_items(search_string)
 
+        if mode == UIMode.STEAM:
+            return self.get_steam_games(search_string)
+
     def get_commands_with_path(self, path):
         commands_to_return = []
         print(self)
@@ -196,6 +201,29 @@ def get_history_items(self, search_string):
 
         return results
 
+    def scan_steam_games(self):
+        """Trigger a scan of the Steam library."""
+        self.steam_scanner.scan_games()
+
+    def get_steam_games(self, search_string):
+        """Get Steam games, optionally filtered by search string."""
+        steam_games = self.steam_scanner.get_games_as_items()
+
+        if search_string == "":
+            return steam_games
+
+        # Use fuzzy subsequence search on game names
+        results = fuzzy_search(
+            search_string, steam_games, lambda game: game["name"]
+        )
+
+        if results:
+            SoundPlayer.play("type")
+        else:
+            SoundPlayer.play("type")
+
+        return results
+
     def add_snippet(self, name, contents):
         with open("snippets/" + name + ".txt", "w", encoding="utf-8") as outputFile:
             outputFile.write(contents)

src/managers/data_manager.py

@@ -191,6 +191,12 @@ def update_list(self, event=None):
             self.mode = UIMode.COMMANDS
             self.edit.Value = ""
 
+        if self.edit.Value == ",":
+            SpeechService.speak(_("Steam games mode"))
+            self.dataManager.scan_steam_games()
+            self.mode = UIMode.STEAM
+            self.edit.Value = ""
+
         self.commands_in_ui = []
         self.list.Clear()
 
@@ -250,6 +256,11 @@ def run_button_clicked(self, event):
                 SoundPlayer.play("copy")
                 copy_to_clipboard(str(selected_option["name"]))
 
+            if selected_option["type"] == "steam":
+                appid = str(selected_option["appid"])
+                webbrowser.open(f"steam://rungameid/{appid}")
+                SoundPlayer.play("run")
+
         except Exception as e:
             import traceback
 

src/managers/ui_manager.py

@@ -0,0 +1,60 @@
+import os
+import re
+import uuid
+
+
+class SteamScanner:
+    def __init__(self, library_path=None):
+        self.library_path = library_path or r"C:\Program Files (x86)\Steam\steamapps"
+        self.games = []
+
+    def scan_games(self):
+        """Scan Steam library for installed games by parsing appmanifest files."""
+        self.games = []
+
+        if not os.path.exists(self.library_path):
+            return self.games
+
+        try:
+            for filename in os.listdir(self.library_path):
+                if filename.startswith("appmanifest_") and filename.endswith(".acf"):
+                    filepath = os.path.join(self.library_path, filename)
+                    game = self._parse_appmanifest(filepath)
+                    if game:
+                        self.games.append(game)
+        except OSError:
+            pass
+
+        # Sort games alphabetically by name
+        self.games.sort(key=lambda g: g["name"].lower())
+        return self.games
+
+    def _parse_appmanifest(self, filepath):
+        """Parse a single appmanifest ACF file to extract game info."""
+        try:
+            with open(filepath, "r", encoding="utf-8") as f:
+                content = f.read()
+
+            appid_match = re.search(r'"appid"\s+"(\d+)"', content)
+            name_match = re.search(r'"name"\s+"([^"]+)"', content)
+
+            if appid_match and name_match:
+                appid = appid_match.group(1)
+                name = name_match.group(1)
+                return {
+                    "name": name.lower(),
+                    "shortcut": "",
+                    "id": str(uuid.uuid4()),
+                    "appid": appid,
+                    "type": "steam",
+                }
+        except (OSError, UnicodeDecodeError):
+            pass
+
+        return None
+
+    def get_games_as_items(self):
+        """Return games in UI format."""
+        if not self.games:
+            self.scan_games()
+        return self.games