Instalacja na Linuksie

GameVox działa na większości dystrybucji Linuksa. Wybierz format, który najlepiej pasuje do twojego systemu.

Flatpak (SteamOS / Steam Deck / uniwersalny)

Wersja Flatpak zawiera wszystkie zależności (WebKit2GTK, GTK3, GStreamer) dzięki środowisku uruchomieniowemu GNOME. To jedyna opcja dla SteamOS, bo nie ma w nim WebKit2GTK, a główny system plików jest tylko do odczytu.

Instalacja z pobranego pliku

  1. Pobierz paczkę .flatpak ze strony pobierania
  2. Otwórz terminal (na Steam Decku najpierw przełącz się na tryb pulpitu)
  3. Uruchom:
flatpak install gamevox-client-x86_64.flatpak

Uruchamianie

flatpak run com.gamevox.GameVox

Po instalacji GameVox pojawi się też w menu aplikacji.

Wskazówka dla Steam Decka: przełącz się na tryb pulpitu (przytrzymaj przycisk zasilania → Przełącz na pulpit). Potem możesz dodać GameVox jako grę spoza Steam w trybie gry, żeby mieć do niego szybki dostęp.

AppImage (uniwersalny)

Jeden przenośny plik wykonywalny. Bez instalacji: wystarczy pobrać, nadać uprawnienia do uruchamiania i odpalić.

  1. Pobierz AppImage ze strony pobierania
  2. Nadaj mu uprawnienia do uruchamiania:
chmod +x GameVox-*.AppImage
  1. Uruchom go:
./GameVox-*.AppImage
Uwaga: AppImage wymaga zainstalowanych w systemie WebKit2GTK i GTK3. Jeśli pojawi się błąd brakującej biblioteki, zajrzyj do sekcji Zależności poniżej albo użyj wersji Flatpak.

.deb (Ubuntu, Debian, Mint, Pop!_OS)

Pobierz paczkę .deb ze strony pobierania i zainstaluj ją:

sudo dpkg -i gamevox-client-*-amd64.deb sudo apt-get install -f # Doinstaluj brakujące zależności

Albo bezpośrednio przez apt (sam zajmie się zależnościami):

sudo apt install ./gamevox-client-*-amd64.deb

GameVox będzie dostępny w menu aplikacji, możesz też uruchomić gamevox z terminala.

.rpm (Fedora, RHEL, openSUSE)

Pobierz paczkę .rpm ze strony pobierania i zainstaluj ją:

Fedora / RHEL

sudo dnf install gamevox-client-*-x86_64.rpm

openSUSE

sudo zypper install gamevox-client-*-x86_64.rpm

Arch / Manjaro / EndeavourOS

Najprościej zainstalować GameVox na dystrybucjach opartych na Archu przez paczkę z AUR:

paru -S gamevox-launcher-bin

Albo, jeśli używasz yay:

yay -S gamevox-launcher-bin

To instaluje launcher, który zajmuje się automatycznymi aktualizacjami i wykrywaniem zależności.

Zależności

Wszystkie formaty poza Flatpakiem wymagają tych bibliotek systemowych:

  • WebKit2GTK (najlepiej 4.1, 4.0 też jest obsługiwane)
  • GTK 3
  • PulseAudio (albo PipeWire z kompatybilnością z PulseAudio)
  • GStreamer plugins-bad (do głosu przez WebRTC w silniku przeglądarki)
  • libayatana-appindicator3 (opcjonalne, zalecane): włącza ikonę w zasobniku systemowym i opcję „minimalizuj do zasobnika”. Wymagane na Hyprlandzie, sway, GNOME i każdym kompozytorze działającym tylko na Waylandzie. Bez tej biblioteki zamknięcie okna wyłącza aplikację zamiast ją ukryć.

Polecenia instalacji dla dystrybucji

DystrybucjaPolecenie
Ubuntu / Debiansudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 gstreamer1.0-plugins-base gstreamer1.0-plugins-bad libayatana-appindicator3-1
Fedorasudo dnf install webkit2gtk4.1 gtk3 gstreamer1-plugins-base gstreamer1-plugins-bad-free libayatana-appindicator-gtk3
Arch / Manjarosudo pacman -S webkit2gtk-4.1 gtk3 gst-plugins-base gst-plugins-bad libayatana-appindicator
openSUSEsudo zypper install webkit2gtk3 gtk3 gstreamer-plugins-base gstreamer-plugins-bad libayatana-appindicator3-1
Void Linuxsudo xbps-install webkit2gtk gtk+3 gst-plugins-base1 gst-plugins-bad1 libayatana-appindicator
Używasz Flatpaka? Nie musisz nic z tego instalować. Flatpak zawiera wszystko dzięki środowisku uruchomieniowemu GNOME.

Rozwiązywanie problemów

Błąd brakującego WebKit2GTK

Jeśli widzisz "Missing required libraries: WebKit2GTK", zainstaluj zależności dla swojej dystrybucji z tabeli powyżej. Jeśli twoja dystrybucja nie ma paczki WebKit2GTK (jak SteamOS), użyj wersji Flatpak.

AppImage się nie uruchamia / błąd FUSE

Jeśli widzisz "AppImages require FUSE to run" albo "error loading libfuse.so.2", w systemie brakuje libfuse2. Wiele nowoczesnych dystrybucji (Fedora, wersje niezmienne itp.) ma zamiast tego fuse3.

Zainstaluj libfuse2 ręcznie:

# Ubuntu/Debian sudo apt install libfuse2 # Fedora sudo dnf install fuse-libs

Upewnij się, że plik ma uprawnienia do uruchamiania: chmod +x GameVox-*.AppImage

Brak czatu głosowego / „Go Native WebRTC” w logach

Niektóre dystrybucje (zwłaszcza Ubuntu i Debian) kompilują WebKit2GTK bez obsługi WebRTC. GameVox to wykrywa i automatycznie przełącza się na wbudowany silnik głosowy. Jeśli głos nadal nie działa, sprawdź, czy masz zainstalowane GStreamer plugins-bad:

# Ubuntu/Debian sudo apt install gstreamer1.0-plugins-bad gstreamer1.0-nice # Fedora sudo dnf install gstreamer1-plugins-bad-free

Minimalizacja do zasobnika nie działa / aplikacja się wyłącza po zamknięciu okna

GameVox potrzebuje ikony w zasobniku systemowym, żeby działać w tle. Na większości nowoczesnych konfiguracji Linuksa (Hyprland, sway, GNOME, KDE) wymaga to biblioteki libayatana-appindicator3 oraz panelu lub paska, który pokazuje ikony zasobnika.

1. Zainstaluj bibliotekę:

# Ubuntu/Debian sudo apt install libayatana-appindicator3-1 # Fedora sudo dnf install libayatana-appindicator-gtk3 # Arch/Manjaro sudo pacman -S libayatana-appindicator # openSUSE sudo zypper install libayatana-appindicator3-1

2. Upewnij się, że twój pulpit ma hosta zasobnika:

  • KDE Plasma, XFCE, MATE, Cinnamon, LXQt, Budgie: wbudowane, nic nie trzeba robić.
  • GNOME: zainstaluj rozszerzenie AppIndicator Support (wiele kafelkowych rozszerzeń GNOME też ma obsługę zasobnika).
  • Hyprland / sway / river / Niri: włącz moduł tray w waybar albo użyj panelu takiego jak nwg-panel.

Po instalacji uruchom GameVox ponownie. W logu powinno pojawić się [Tray] AppIndicator (StatusNotifierItem) created. Jeśli nadal widać "your desktop environment does not support GtkStatusIcon", biblioteka nie jest znajdowana. Sprawdź, czy jest zainstalowana: ldconfig -p | grep ayatana.

Problemy z wyświetlaniem na Waylandzie

W sesjach Waylanda GameVox wymusza backend X11 przez XWayland, żeby uniknąć problemów z wejściem w oknach bez ramki w kafelkowych menedżerach okien (Sway, Hyprland, Niri). Jeśli masz problemy z wyświetlaniem, upewnij się, że XWayland jest zainstalowany.

Dźwięk udostępniania ekranu nie działa

Dźwięk udostępniania ekranu korzysta z przechwytywania pojedynczego okna, które zapewnia silnik przeglądarki. Upewnij się, że działa PipeWire (albo PulseAudio). W niektórych kompozytorach Waylanda może być potrzebne nadanie uprawnień do przechwytywania ekranu przez XDG Desktop Portal.