gamelauncher/README.md

1.3 KiB
Raw Permalink Blame History

Game Launcher — GNOME Shell Extension

A top-panel game launcher for Steam and custom games, styled as a modern popup with filter tabs, a "Continue playing" hero banner, and a scrollable game grid.

Features

  • Auto-detects installed Steam games from all library folders
  • Reads playtime and last-played data from Steam's local config
  • Detects non-Steam games added to Steam (shortcuts.vdf)
  • Add custom non-Steam games via preferences
  • Filter tabs: All, Recent, Steam
  • Continue playing hero banner for your most recent game

Requirements

  • GNOME Shell 4550
  • Steam installed (for Steam game detection)
  • Libadwaita (for preferences)

Install

make install
make compile-schemas

Restart GNOME Shell to load the extension: press Alt+F2, type r, and press Enter.

Then enable Game Launcher in Extension Manager, or:

gnome-extensions enable gamelauncher@floweringmind

Preferences

gnome-extensions prefs gamelauncher@floweringmind

Use preferences to add, edit, or remove custom games (name, launch command, optional cover image).

Uninstall

make uninstall
make reload

Development

make reload   # Restart GNOME Shell after code changes
make zip      # Package for distribution

License

GPL-3.0-or-later