gamelauncher/README.md

60 lines
1.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```bash
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:
```bash
gnome-extensions enable gamelauncher@floweringmind
```
## Preferences
```bash
gnome-extensions prefs gamelauncher@floweringmind
```
Use preferences to add, edit, or remove custom games (name, launch command, optional cover image).
## Uninstall
```bash
make uninstall
make reload
```
## Development
```bash
make reload # Restart GNOME Shell after code changes
make zip # Package for distribution
```
## License
GPL-3.0-or-later