gaming-cli

gaming-cli to główne narzędzie do zarządzania trybem gry wbudowane w HackerOS Gaming Edition. Pozwala przełączać system między środowiskiem KDE Plasma a trybem gry opartym na Gamescope i Steam Big Picture Mode — bez potrzeby ponownego uruchamiania systemu.

Narzędzie oferuje zarówno interaktywne TUI (terminal user interface) zbudowane na BubbleTea, jak i klasyczny interfejs CLI do użycia w skryptach i skrótach klawiszowych. Na pulpicie znajdziesz gotowy skrót Switch to Game Mode, który uruchamia przełączenie jednym kliknięciem.

Wymagania

Tryb interaktywny (TUI)

Uruchomienie gaming-cli lub gaming bez argumentów otwiera pełnoekranowy interfejs TUI zbudowany na BubbleTea i Lip Gloss.

gaming-cli
# lub krócej:
gaming

TUI oferuje menu z następującymi opcjami:

Nawigacja w TUI

Interfejs CLI

gaming-cli akceptuje komendy jako argumenty wiersza poleceń — przydatne w skryptach, regułach udev i skrótach klawiszowych pulpitu.

gaming-cli <komenda> [argumenty]

switch

Przełącza system między trybem gry a trybem pulpitu.

gaming-cli switch game-mode
gaming-cli switch desktop-mode

Działanie switch game-mode:

1. Sprawdza aktualny tryb — jeśli już w game-mode, kończy z komunikatem
2. Zatrzymuje sddm.service (zamknięcie KDE Plasma)
3. Czeka 2 sekundy na zamknięcie display servera
4. Przełącza konsolę na TTY2 (chvt 2)
5. Uruchamia hackeros-game-mode.service (Gamescope + Steam BPM)
6. Zapisuje stan do /var/lib/hackeros-gaming/current-mode

Działanie switch desktop-mode:

1. Sprawdza aktualny tryb — jeśli już w desktop-mode, kończy z komunikatem
2. Zatrzymuje hackeros-game-mode.service lub ubija proces gamescope
3. Czeka na zakończenie procesu
4. Przełącza konsolę na TTY1 (chvt 1)
5. Uruchamia sddm.service
6. Zapisuje stan trybu

status

Wyświetla aktualnie aktywny tryb.

gaming-cli status

  Aktywny tryb :  🎮 GAME MODE 

info

Wyświetla szczegółowe informacje o środowisku gaming.

gaming-cli info

  📊 Środowisko gaming
  ────────────────────────────────────────────────────────
  Dystrybucja    : HackerOS Gaming Edition 4.7
  Debian         : forky/sid
  Jądro          : 6.12.0-xanmod1
  GPU            : NVIDIA GeForce RTX 4070 Ti
  Gamescope      : gamescope 3.15.x
  Steam          : zainstalowany (/usr/bin/steam)
  Tryb           : game-mode

gamescope

Uruchamia gamescope bezpośrednio z przekazanymi argumentami.

gaming-cli gamescope --width 1920 --height 1080 --refresh 144
gaming-cli gamescope -f -w 2560 -h 1440

version

gaming-cli version

  gaming-cli 0.0.1
  HackerOS Gaming Edition · Debian Testing (Forky)

Wrapper gaming

gaming to krótki wrapper dla gaming-cli — zamiast wpisywać pełne komendy, możesz używać intuicyjnych skrótów:

gamescope-manager

gamescope-manager to narzędzie zarządzające sesją Gamescope, wywoływane przez gaming-cli w tle (lub przez serwis systemd hackeros-game-mode.service). Możesz też używać go bezpośrednio:

gamescope-manager start                    # uruchom z domyślną konfiguracją
gamescope-manager start --width 2560 --height 1440 --refresh 144
gamescope-manager start --no-steam         # sam gamescope bez Steam
gamescope-manager stop                     # zatrzymaj sesję
gamescope-manager restart
gamescope-manager status
gamescope-manager config                   # pokaż konfigurację
gamescope-manager config set refresh 144  # zmień klucz
gamescope-manager config reset             # przywróć domyślne

Opcje dla start

Konfiguracja gamescope-manager

Konfiguracja jest przechowywana w pliku /etc/hackeros/gamescope-manager.hk w autorskim formacie HackerOS .hk.

Przykład pliku konfiguracyjnego (.hk)

! HackerOS Gamescope Manager — konfiguracja
! Format: .hk (HackerOS Configuration Format)

[gamescope]
-> width       => 2560
-> height      => 1440
-> refresh     => 144
-> fullscreen  => true
-> vsync       => true
-> hdr         => false
-> mangoapp    => true
-> auto_steam  => true
-> extra_flags => []

Format konfiguracyjny .hk

HackerOS używa autorskiego formatu plików konfiguracyjnych .hk (HackerOS Configuration Format). Pełna dokumentacja formatu wraz ze specyfikacją składni, typami wartości i przykładami dostępna jest tutaj:

📄 Dokumentacja formatu .hk →

Roadmapa

Krótkoterminowo (v0.1.x)

Średnioterminowo (v0.2.x)

Długoterminowo (v1.0)

Licencja

gaming-cli, gaming i gamescope-manager są udostępniane na licencji GNU GPL3.