Files
SyncGames/docs/linux-gui-appimage.md
T
DawnsorrowandCursor 0d6b0b2f80 Initial SyncGames tree: agent, Android, deploy, docs.
Session-gated MinIO save sync with AppImage GUI, CLI edit/session flow, and Gitea release helper.

Co-authored-by: Cursor <[email protected]>
2026-07-14 22:06:36 -05:00

27 lines
861 B
Markdown

# Linux GUI + AppImage
The SyncGames AppImage launches a thin PySide6 manager for initial setup and day-to-day session ops.
## Tabs
| Tab | Actions |
|-----|---------|
| Setup | Endpoint, keys, device id, save `agent.toml`, Doctor probe, seed example games, install systemd units |
| Games | List / add / retire games (same TOML as CLI) |
| Session | Start / End / Status / History / Restore (YES confirm) |
## Build
```bash
cd agent
./packaging/build-appimage.sh
```
Requires network once to fetch `appimagetool` if missing.
## Notes
- Credentials and config are written to `~/.config/syncgames/agent.toml` (mode 0600), not into the AppImage.
- Watcher automation still uses `systemctl --user enable --now syncgames-watch@<game-id>.service` after units are installed.
- CLI remains available via `pip install -e .` (`syncgames …`) alongside the GUI.