Metadata-Version: 2.4
Name: gamectl
Version: 1.2.1
Summary: Sovereign TUI Game Manager & Launcher for Linux & Steam Deck Power Users
Author-email: zyekhabdul <zyekhabdulqadirjailani@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/zyekhabdul/gamectl
Project-URL: Repository, https://github.com/zyekhabdul/gamectl.git
Project-URL: Issues, https://github.com/zyekhabdul/gamectl/issues
Project-URL: Changelog, https://github.com/zyekhabdul/gamectl/blob/main/CHANGELOG.md
Keywords: gamectl,gaming,linux-gaming,steam,proton,steam-deck,wine,tui,cli,launcher,gamescope,mangohud
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Unix Shell
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<div align="center">

# gamectl

### Sovereign TUI Game Manager & Launcher for Linux Purists

*Zero Electron. Zero Chromium. Zero Bloat. Sub-80ms Startup.*

[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20SteamDeck-blue?style=for-the-badge&logo=linux&logoColor=white)](https://github.com/zyekhabdul/gamectl)
[![Shell](https://img.shields.io/badge/Shell-POSIX%20Bash-4EAA25?style=for-the-badge&logo=gnu-bash&logoColor=white)](https://github.com/zyekhabdul/gamectl)
[![Memory](https://img.shields.io/badge/Memory-<%2015%20MB%20RSS-brightgreen?style=for-the-badge&logo=speedtest&logoColor=white)](https://github.com/zyekhabdul/gamectl)
[![Startup](https://img.shields.io/badge/Startup-<%2080ms-success?style=for-the-badge&logo=lightning&logoColor=white)](https://github.com/zyekhabdul/gamectl)
[![Tests](https://img.shields.io/badge/Tests-59%2F59%20Passing-success?style=for-the-badge&logo=checkmarx&logoColor=white)](https://github.com/zyekhabdul/gamectl)
[![PyPI](https://img.shields.io/badge/PyPI-gamectl-3775A9?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/gamectl/)
[![License](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge)](LICENSE)
[![Display](https://img.shields.io/badge/Compositor-Wayland%20%7C%20X11-orange?style=for-the-badge&logo=wayland&logoColor=white)](https://github.com/zyekhabdul/gamectl)
[![Packaging](https://img.shields.io/badge/Packaging-Arch%20PKGBUILD%20%7C%20Universal-1793D1?style=for-the-badge&logo=arch-linux&logoColor=white)](packaging/arch/PKGBUILD)

```bash
# Turnkey Instant Installation
curl -fsSL https://raw.githubusercontent.com/zyekhabdul/gamectl/main/install.sh | bash
```

[Quickstart](#quick-installation) • [Benchmark](#benchmark-matrix-headless-sovereign-vs-gui-launchers) • [Core Capabilities](#core-capabilities) • [Keyboard Shortcuts](#keyboard-shortcuts-reference) • [CLI Reference](#cli-command-reference) • [Ecosystems](#supported-ecosystems--handhelds) • [Architecture](docs/ARCHITECTURE.md)

</div>

---

```text
╭─ GAMECTL SOVEREIGN COCKPIT ──────────────────┬─ RUNTIME INSPECTION ──────────────────────────────╮
│ [GBE_FORK]  Hades II                         │ AppID     : 1145360 (Hades II)                    │
│ [VALVE_DLL] Balatro                          │ Arch      : Windows PE32+ (x86_64)                │
│ [STANDALONE] Dead Cells                      │ Runner    : GE-Proton9-25 (~/.local/share/Steam/) │
│ [GBE_FORK]  Factorio                         │ Prefix    : Isolated ($GAME_DIR/pfx)              │
│ [STANDALONE] Slay the Spire                  │ Wrappers  : GameMode: ON │ MangoHud: ON │ FSR: OFF│
│ [VALVE_SO]  Celeste                          │ Audio     : PipeWire 256/48000 (Low Latency)      │
│ [GBE_FORK]  Hollow Knight: Silksong          │ Saves     : 3-Slot Disaster Guard (slot1/slot2)   │
│ [STANDALONE] Terraria                        │ Sandbox   : Bubblewrap (bwrap: ~/.ssh shielded)   │
│ [VALVE_DLL] Elden Ring                       │ Isolation : cgroups v2 (systemd-run scope)        │
╰──────────────────────────────────────────────┴───────────────────────────────────────────────────╯
```

**gamectl** is an ultra-lightweight (< 15 MB RAM RSS), high-performance Terminal User Interface (TUI) game manager and launcher designed for Linux workstations and handhelds. It manages, launches, and synchronizes standalone portable games with zero dependency on heavyweight graphical client runtimes (such as Electron, Chromium, or CEF).

Engineered for Linux purists and minimalist desktop environments (Wayland / Niri / Sway / Hyprland / X11), `gamectl` delivers instant sub-80ms startup, isolated runtime prefixes, decentralized LAN multiplayer, and disaster-proof savegame snapshotting.

---

## Benchmark Matrix: Headless Sovereign vs GUI Launchers

Empirical comparisons measured on Arch Linux x86_64 (Linux kernel 6.x, AMD Ryzen / Intel Core, NVMe storage):

| Metric / Dimension | `gamectl` (TUI) | Heroic Games Launcher | Lutris | Bottles |
| :--- | :--- | :--- | :--- | :--- |
| **Startup Latency** | **< 80 ms** | ~1,200 - 2,500 ms | ~2,200 - 3,500 ms | ~3,100 - 4,800 ms |
| **Idle Memory (RSS)** | **< 15 MB** | ~180 - 380 MB | ~120 - 240 MB | ~200 - 420 MB |
| **Runtime Stack** | **POSIX Bash + fzf + jq** | Electron + Chromium + Node | Python 3 + GTK 3/4 | Python 3 + GTK 4 + libadwaita |
| **Prefix Architecture** | **Per-game isolated (`./pfx`)** | Global / Managed per game | Shared / Centralized | Flatpak / Centralized bottles |
| **Savegame Disaster Guard** | **Automated 3-slot rotation** | Manual / Cloud-dependent | None (Manual sync) | Centralized snapshots |
| **Audio Latency Tuning** | **Automated PipeWire/Pulse** | Manual environment variables | Manual environment variables | Manual environment variables |
| **Wineserver Teardown** | **Deterministic sync & kill** | Prone to orphan daemons | Prone to lingering processes | Handled via Flatpak sandbox |
| **Headless / Remote Ops** | **100% Native CLI & TUI** | No (GUI required) | Partial CLI | No (GUI required) |
| **Asset Overhead** | **Zero bundled web assets** | ~150 - 300 MB disk space | ~80 - 150 MB disk space | ~200 - 400 MB disk space |

---

## Supported Ecosystems & Handhelds

| Ecosystem / Platform | Target Architecture | Support Level | Integration Details |
| :--- | :--- | :--- | :--- |
| **Arch Linux / EndeavourOS** | x86_64 | **Native Tier 1** | Standalone binary & `packaging/arch/PKGBUILD` AUR recipe |
| **Steam Deck (SteamOS)** | AMD Van Gogh (x86_64) | **Native Tier 1** | Desktop Mode TUI + Steam Deck Game Mode (`shortcuts.vdf` + artwork) |
| **Bazzite / ChimeraOS** | Immutable Linux | **Native Tier 1** | Rootless turnkey installation to `~/.local/bin/` |
| **Debian / Ubuntu / Linux Mint** | x86_64 | **Verified** | Standard package dependencies via APT |
| **Fedora / Nobara** | x86_64 | **Verified** | Standard package dependencies via DNF |
| **Wayland (Niri / Sway / Hyprland)** | Wayland socket pass-through | **Verified** | Full Gamescope FSR & dynamic `$WAYLAND_DISPLAY` binding |
| **X11 (i3 / bspwm / XFCE)** | Native X11 | **Verified** | Automatic `$XAUTHORITY` and DISPLAY detection |
| **Handheld PCs (ROG Ally, Legion Go)** | AMD Phoenix / Z1 Extreme | **Verified** | Low-overhead execution freeing maximum VRAM for 3D shaders |

---

## Core Capabilities

- **Zero-Bloat & Instant Startup**: Written in pure POSIX Bash, `fzf`, and `jq`. Cuts 95%+ memory overhead compared to conventional graphical game launchers.
- **Dynamic Multi-Library Autodetection**: Automatically scans and aggregates games across all Steam library partitions (`libraryfolders.vdf` + ACF manifests), portable directories (`~/Games/`), Lutris paths, and custom locations via `~/.config/gamectl/libraries` or `GAMECTL_LIBRARY_DIRS`.
- **Split-Pane Live Inspection Cockpit**: Left pane lists your library with ANSI status badges; right pane streams real-time binary architectures (ELF 32/64-bit, PE32/PE32+), runner paths, wrapper profiles, LAN multiplayer personas, and savegame sizes.
- **cgroups v2 Process Tree Isolation (`gamectl launch --scope`)**: Encapsulates game execution in a dedicated systemd user scope (`gamectl-<title>-<pid>`), terminating all background helpers (`winedevice.exe`, `explorer.exe`, crash reporters) atomically on exit with zero zombie processes.
- **Automated PRIME Hybrid dGPU Offload (`gamectl launch --prime`)**: Auto-probes `/sys/bus/pci/devices/` and routes rendering to secondary discrete NVIDIA (`__NV_PRIME_RENDER_OFFLOAD=1`), AMD, or Intel Arc (`DRI_PRIME=1`) controllers without manual environment variable hacking.
- **Rootless Bubblewrap Security Sandbox (`gamectl launch --sandbox`)**: Mounts host root as read-only and shields private directories (`~/.ssh`, `~/.gnupg`, browser cookies, and `.env` credentials) inside a hardened tmpfs namespace while transparently passing Wayland/X11 and PipeWire audio sockets.
- **Disaster-Proof Savegame Snapshots**: Automatically creates a 3-slot rotating backup (`slot1`, `slot2`, `slot3`) before each game launch, safeguarding your save states against crashes and dirty shutdowns.
- **Decentralized LAN Steam Emulator (`gamectl inject`)**: Converts Valve binaries (Linux native `.so` and Windows `.dll` x86/x64) into portable standalone runtimes featuring local `./saves` redirection and automated `steam_settings/DLC.txt` generation.
- **Isolated Windows Runner & Prefix Engine**: Discovers installed Windows compatibility runners (`umu-run` -> `GE-Proton` / Steam `Proton` -> `wine`) and maintains strictly isolated prefixes in `$GAME_DIR/pfx`, keeping host `~/.wine` pristine.
- **Modular Performance Wrappers**: On-the-fly toggle for `gamemoderun`, `mangohud`, `gamescope` dynamic FSR upscaling, and Mesa multithreaded GL via interactive dialogs (`<Ctrl-O>`) or CLI flags.
- **LAN Multi-Identity & SteamID Manager (`gamectl set-id`)**: Generates deterministic 17-digit SteamID64 tokens and distinct LAN gamer tags to prevent co-op network collisions, with custom peer discovery (`custom_broadcasts.txt`).
- **Headless Asset Downloader Engine (`gamectl download`)**: Downloads game files directly from content servers via DepotDownloader CLI in foreground or detached background modes without requiring a GUI client.
- **Steam Entitlement & ACF Adoption Engine (`gamectl entitle`, `gamectl adopt-steam`)**: Adopts local/offline files into the official Steam client, unlocking community Steam Input mappings (gyro/touchpad), Valve CDN Vulkan shader pre-caching, and base-game DLC activation via `~/.config/SLSsteam/config.yaml` and native `appmanifest_<appid>.acf`. (Backward-compatible alias: `gamectl unlock`).
- **Universal Mod DLL Overrides & P2P Hook Engine (`gamectl mod-overrides`)**: Detects mod loaders and P2P compatibility layers (BepInEx, UE4SS, REFramework, ReShade, OnlineFix), injects deduplicated `WINEDLLOVERRIDES`, and registers Spacewar AppID 480.
- **Headless GE-Proton Release Manager (`gamectl proton-*`)**: Fetches upstream GitHub releases, streams tarball installation directly into `~/.local/share/Steam/compatibilitytools.d/`, and prunes older versions safely.
- **Wine Prefix Swiss Army Knife (`gamectl pfx`) & Wineserver Guard**: Dedicated maintenance toolkit (`winecfg`, `regedit`, `cmd`, `shell`, `winetricks`, `kill`, `clean`) with deterministic wineserver teardown (`wineserver -w` / `-k`) to eliminate registry lock contention.
- **Real-Time PipeWire Audio Scheduling**: Exports optimal quantum buffer configurations (`PIPEWIRE_LATENCY="256/48000"`, `PULSE_LATENCY_MSEC=60`) to prevent audio crackling and buffer starvation during high CPU spikes.
- **One-Key Multi-Node Sync (`<Ctrl-S>`)**: Synchronizes portable save states to secondary handhelds or remote servers over SSH/Rsync with pre-flight network checks.
- **Steam Store Catalog & ProtonDB Compatibility Audit**: Fast online search integrating public Steam Store metadata with live ProtonDB Linux compatibility tier ratings (Native, Platinum, Gold, Silver, Bronze, Borked).

---

## Keyboard Shortcuts Reference

The interactive TUI library navigation provides instantaneous single-keystroke operations:

| Shortcut | Action Description |
| :--- | :--- |
| `<ENTER>` | Launch Game (Automatic save snapshot + runner resolution + wrappers) |
| `<Ctrl-O>` | Configure Runtime Wrappers (GameMode / MangoHud / Gamescope FSR / Mesa GL) |
| `<Ctrl-P>` | Configure LAN Multiplayer Gamer Tag & SteamID64 Persona |
| `<Ctrl-I>` | Inject Decentralized LAN Runtime & Entitlement Sync |
| `<Ctrl-S>` | Sync Portable Savegame to Remote Companion Host via SSH |
| `<Ctrl-B>` | Create Manual Savegame Snapshot Slot |
| `<Ctrl-F>` | Search Steam Store Catalog & Audit ProtonDB Rating |
| `<Ctrl-D>` | Open Background Download Monitor |
| `<ESC>` / `<Ctrl-C>` | Return to Master Dashboard Hub / Exit |

---

## Multi-Platform Installation

### Option 1: Turnkey One-Liner (Universal Linux & Steam Deck)
```bash
curl -fsSL https://raw.githubusercontent.com/zyekhabdul/gamectl/main/install.sh | bash
```

### Option 2: Arch Linux (AUR & AUR-Git)
```bash
# Release package:
yay -S gamectl
# or development branch (VCS):
paru -S gamectl-git
```

### Option 3: Debian / Ubuntu (.deb Package)
```bash
# Build and install Debian package:
make pkg-deb
sudo dpkg -i packaging/debian/gamectl_1.2.0_all.deb
sudo apt install -f
```

### Option 4: Homebrew Tap (Linux & macOS)
```bash
brew tap zyekhabdul/tap
brew install gamectl
```

### Option 5: Nix Flake (NixOS / Declarative)
```bash
# Run directly without installation:
nix run github:zyekhabdul/gamectl

# Or add to your NixOS flake inputs:
# inputs.gamectl.url = "github:zyekhabdul/gamectl";
```

### Option 6: Python Package (pipx & pip)
```bash
# Recommended for modern Linux (PEP 668):
pipx install gamectl

# Or inside standard virtualenv:
pip install gamectl
```

### Option 7: Manual Source Clone & Turnkey Installer
```bash
git clone git@github.com:zyekhabdul/gamectl.git
cd gamectl
./install.sh
```

The turnkey installer automatically executes:
1. Compiles or symlinks standalone binary `gamectl` and shorthand alias `game` to `~/.local/bin/`.
2. Scaffolds configuration directory and templates in `~/.config/gamectl/`.
3. Installs shell completion script to `~/.local/share/bash-completion/completions/gamectl`.
4. Registers FreeDesktop entry `gamectl.desktop` for Wayland/X11 application launchers (rofi, fuzzel, wofi, dmenu).
5. Verifies runtime availability of headless tools (DepotDownloader, compatibility templates).

---

## CLI Command Reference

`gamectl` is fully operational as both an interactive TUI and a scriptable CLI tool:

### 1. Interactive TUI Navigation
```bash
gamectl               # Launch Master Dashboard Hub TUI
gamectl library       # Open Game Library TUI directly (alias: list-ui)
gamectl config        # Open global configuration editor (alias: configure)
gamectl doctor        # Run 7-layer system & GPU health diagnostics (alias: audit)
```

### 2. Launching Games
```bash
# Launch with MangoHud and GameMode enabled:
gamectl launch "$HOME/Games/DeadCells" --hud --gamemode

# Launch Windows executable with Gamescope FSR upscaling:
gamectl launch "$HOME/Games/WindowsGame" game.exe --gamescope --fsr

# Launch with cgroups v2 process tree isolation (systemd-run scope):
gamectl launch "$HOME/Games/HeavyGame" --scope

# Launch with automated PRIME hybrid discrete GPU offloading (NVIDIA / AMD / Intel Arc):
gamectl launch "$HOME/Games/3DGame" --prime

# Launch inside rootless Bubblewrap (bwrap) security sandbox (shielding ~/.ssh, ~/.gnupg, cookies):
gamectl launch "$HOME/Games/UntrustedGame" --sandbox

# Configure per-game wrapper persistence:
gamectl configure-wrappers "$HOME/Games/DeadCells"
```

### 3. Linux Kernel Isolation & Hardware Diagnostics
```bash
# Detect discrete secondary GPU vendor on hybrid laptop/desktop systems:
gamectl detect-gpu

# Check if systemd-run user scope cgroups v2 isolation is supported:
gamectl check-scope

# Check if Bubblewrap rootless sandbox profile is available:
gamectl check-sandbox
```

### 4. P2P Multiplayer Compatibility & Mod DLL Overrides
```bash
# Setup P2P compatibility layer, DLL overrides, and Spacewar AppID 480:
gamectl mod-overrides "$HOME/Games/CoopGame"

# Backward-compatible command alias:
gamectl onlinefix "$HOME/Games/CoopGame"
```

### 5. GE-Proton Release Manager
```bash
# Query installed local releases vs latest upstream releases on GitHub:
gamectl proton-list

# Install latest GE-Proton release (or specify version tag):
gamectl proton-install latest
gamectl proton-install GE-Proton9-25

# Safely remove an obsolete GE-Proton version:
gamectl proton-remove GE-Proton8-26
```

### 6. Wine Prefix Swiss Army Knife (`pfx`)
```bash
# Open interactive prefix management menu:
gamectl pfx "$HOME/Games/MyGame"

# Execute Windows utilities inside the isolated prefix:
gamectl pfx "$HOME/Games/MyGame" winecfg
gamectl pfx "$HOME/Games/MyGame" regedit
gamectl pfx "$HOME/Games/MyGame" cmd
gamectl pfx "$HOME/Games/MyGame" shell
gamectl pfx "$HOME/Games/MyGame" winetricks d3dx9 vcrun2022

# Teardown stuck wineserver processes gracefully (DEFECT-02):
gamectl pfx "$HOME/Games/MyGame" kill

# Reset prefix with automatic savegame backup:
gamectl pfx "$HOME/Games/MyGame" clean -y
```

### 7. Decentralized LAN Steam Runtime & Portable Saves
```bash
# Inject standalone LAN runtime and sync offline entitlement (All-in-One):
gamectl inject "$HOME/Games/Limbo" 48000

# Inject standalone LAN runtime only (zero Steam client sync):
gamectl inject "$HOME/Games/Limbo" 48000 --no-sync

# Configure LAN player persona and SteamID64:
gamectl set-id "PlayerTwo" auto "$HOME/Games/Valheim"
gamectl set-id "Alice" 76561198123456789 "$HOME/Games/Valheim" --broadcast "192.168.1.50"
gamectl set-id "MyGamerTag" auto --global
```

### 8. Headless Asset Downloader Engine
```bash
# Download game files, inject decentralized runtime, and sync entitlement:
gamectl download 48000 "$HOME/Games/Limbo" "LIMBO"

# Download game assets only without injection:
gamectl download 48000 "$HOME/Games/Limbo" "LIMBO" --raw

# Run download in foreground (live stream logs):
gamectl download 48000 "$HOME/Games/Limbo" "LIMBO" -f

# Monitor active and completed download tasks:
gamectl downloads
```

### 9. Steam Entitlement & ACF Adoption Engine (Zero-Download Full DLC)
Adopts offline or standalone game files into the official Steam client, enabling community Steam Input (gyro/trackpad profiles), Valve CDN Vulkan shader pre-caching, and full DLC entitlement without re-downloading:

```bash
# Entitle AppID, adopt local assets, and register full DLC into Steam:
gamectl entitle 1145360 "Hades II"     # Aliases: unlock, adopt-steam

# Synchronize installed standalone game files with Steam client:
gamectl sync-steam 427520 "Factorio" "$HOME/Games/Factorio"
```

### 10. ProtonDB Compatibility Audit & Shortcuts
```bash
# Query ProtonDB rating by AppID:
gamectl protondb 105600

# Query ProtonDB rating by game directory:
gamectl protondb "$HOME/Games/Terraria"

# Generate FreeDesktop .desktop application launcher:
gamectl make-desktop "$HOME/Games/Terraria" "Terraria"
```

### 11. Multi-Node Savegame Synchronization
```bash
# Synchronize local savegame snapshots to configured remote companion host:
gamectl --sync "$HOME/Games/Terraria" "Terraria"

# Create immediate manual save snapshot:
gamectl --backup "$HOME/Games/Terraria"
```

---

## Configuration & Environment Variables

`gamectl` respects XDG Base Directory standards and standard Linux configuration paths:

| File / Variable | Description |
| :--- | :--- |
| `~/.config/gamectl/libraries` | Plaintext list of custom game library search paths (one per line). |
| `~/.config/gamectl/wrappers` | Global default wrapper preferences (`gamemode=1`, `hud=1`, `gamescope=0`). |
| `~/.config/gamectl/remote_host` | Hostname or IP of companion remote sync node (`user@hostname`). |
| `~/.config/gamectl/persona` | Global default player gamer tag and SteamID64. |
| `GAMECTL_LIBRARY_DIRS` | Environment variable to inject extra library search paths dynamically. |
| `XDG_RUNTIME_DIR/gamectl-$UID/` | Ephemeral runtime directory for active game tracking and locks. |

---

## Project Structure

```text
gamectl/
├── bin/
│   └── gamectl          # Monolithic standalone compiled executable (source-to-bundle)
├── completions/
│   └── gamectl.bash     # Shell autocompletion script (Bash / Zsh)
├── docs/
│   ├── ARCHITECTURE.md  # Deep dive into headless Linux game management architecture
│   └── GUIDE.md         # Operational handbook, prefix isolation, and disaster recovery
├── packaging/
│   └── arch/            # Arch Linux PKGBUILD packaging recipes
├── scripts/
│   ├── build.sh         # Source-to-bundle deterministic compilation script
│   └── format.sh        # Shell formatting and lint harness
├── src/
│   ├── core/            # Header constants, ANSI palette, snapshot engine, utils
│   ├── diagnostics/     # 7-layer system health audit and ProtonDB client
│   ├── runners/         # Windows runners, prefix manager, DLL overrides, launcher HUD
│   ├── steam/           # Multi-path discovery, identity, and headless downloader
│   ├── tui/             # Master dashboard hub, preview cards, interactive search
│   └── main.sh          # Subshell exports and CLI command dispatcher
├── tests/
│   └── test_cli.sh      # Comprehensive regression & integrity harness (50+ tests)
├── gamectl.desktop      # FreeDesktop application launcher entry
├── install.sh           # Turnkey installation script
└── README.md            # Project manifesto, benchmarks, and command dictionary
```

---

## Community & Stargazers

If `gamectl` freed your RAM, eliminated background browser bloat, or improved your Linux gaming workflow, consider starring the repository on GitHub!

[![Star History Chart](https://api.star-history.com/svg?repos=zyekhabdul/gamectl&type=Date)](https://star-history.com/#zyekhabdul/gamectl&Date)

- **Issues & Discussions**: Found an edge-case or want to propose an optimization? Open an issue on GitHub.
- **Contributions**: Packaging recipes (Nix, Flatpak, Void, Alpine) and hardware profiles are welcome via Pull Requests.

---

## License & Legal Notice

Distributed under the MIT License. See `LICENSE` for details.

`gamectl` is an independent open-source utility designed for managing standalone local game files and compatibility runners on Linux. It does not distribute, host, or bypass proprietary encryption on copyrighted game software. All trademarks and brand names belong to their respective owners.
