Gabay sa Pag-install sa Linux

Gumagana ang GameVox sa karamihan ng Linux distro. Piliin ang format na pinakabagay sa system mo.

Flatpak (SteamOS / Steam Deck / Universal)

Kasama na sa Flatpak version ang lahat ng dependencies (WebKit2GTK, GTK3, GStreamer) gamit ang GNOME runtime. Ito ang tanging option para sa SteamOS dahil wala itong WebKit2GTK at read-only ang root filesystem.

I-install mula sa download

  1. I-download ang .flatpak bundle mula sa Downloads page
  2. Magbukas ng terminal (sa Steam Deck: lumipat muna sa Desktop Mode)
  3. Patakbuhin:
flatpak install gamevox-client-x86_64.flatpak

Buksan

flatpak run com.gamevox.GameVox

Pagkatapos ma-install, lalabas din ang GameVox sa application launcher mo.

Tip para sa Steam Deck: Lumipat sa Desktop Mode (pindutin nang matagal ang power button → Switch to Desktop). Pagkatapos, puwede mong i-add ang GameVox bilang non-Steam game sa Gaming Mode para madali itong mabuksan.

AppImage (Universal)

Isang portable na executable. Walang kailangang i-install: i-download lang, gawing executable, at patakbuhin.

  1. I-download ang AppImage mula sa Downloads page
  2. Gawin itong executable:
chmod +x GameVox-*.AppImage
  1. Patakbuhin:
./GameVox-*.AppImage
Note: Kailangan ng AppImage na naka-install ang WebKit2GTK at GTK3 sa system mo. Kung may lumabas na missing library error, tingnan ang Dependencies section sa ibaba, o gamitin na lang ang Flatpak version.

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

I-download ang .deb package mula sa Downloads page at i-install ito:

sudo dpkg -i gamevox-client-*-amd64.deb sudo apt-get install -f # I-install ang mga kulang na dependencies

O gamit ang apt nang direkta (automatic nitong inaayos ang dependencies):

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

Makikita ang GameVox sa application launcher mo, o puwede mong patakbuhin ang gamevox mula sa terminal.

.rpm (Fedora, RHEL, openSUSE)

I-download ang .rpm package mula sa Downloads page at i-install ito:

Fedora / RHEL

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

openSUSE

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

Arch / Manjaro / EndeavourOS

Ang pinakamadaling paraan para i-install ang GameVox sa mga Arch-based distro ay sa AUR package:

paru -S gamevox-launcher-bin

O kung yay ang gamit mo:

yay -S gamevox-launcher-bin

Ini-install nito ang launcher na bahala sa automatic updates at dependency detection.

Dependencies

Kailangan ng lahat ng format maliban sa Flatpak ang mga system library na ito:

  • WebKit2GTK (mas maganda ang 4.1, supported din ang 4.0)
  • GTK 3
  • PulseAudio (o PipeWire na may PulseAudio compatibility)
  • GStreamer plugins-bad (para sa WebRTC voice gamit ang browser engine)
  • libayatana-appindicator3 (optional, recommended): pinapagana nito ang system tray icon at ang "minimize to tray". Kailangan ito sa Hyprland, sway, GNOME, at kahit anong Wayland-only compositor. Kung wala ito, magsasara ang app kapag isinara mo ang window imbes na maitago lang.

Mga install command bawat distro

DistroCommand
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
Kung Flatpak ang gamit mo: Hindi mo na kailangang i-install ang alinman dito. Kasama na lahat sa Flatpak gamit ang GNOME runtime.

Troubleshooting

Missing WebKit2GTK error

Kung makita mo ang "Missing required libraries: WebKit2GTK", i-install ang dependencies para sa distro mo mula sa table sa itaas. Kung walang WebKit2GTK package ang distro mo (gaya ng SteamOS), gamitin ang Flatpak version.

Ayaw mag-start ng AppImage / FUSE error

Kung makita mo ang "AppImages require FUSE to run" o "error loading libfuse.so.2", wala pang libfuse2 sa system mo. Maraming modernong distro (Fedora, mga immutable variant, atbp.) ang fuse3 ang kasama.

I-install nang manual ang libfuse2:

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

Siguraduhing executable ang file: chmod +x GameVox-*.AppImage

Walang voice chat / "Go Native WebRTC" sa logs

May mga distro (lalo na ang Ubuntu at Debian) na nagco-compile ng WebKit2GTK nang walang WebRTC support. Nade-detect ito ng GameVox at kusa itong lumilipat sa built-in na voice engine. Kung hindi pa rin gumagana ang voice, siguraduhing naka-install ang GStreamer plugins-bad:

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

Hindi gumagana ang minimize to tray / nagsasara ang app kapag isinara ko ang window

Kailangan ng GameVox ng system tray icon para makapagtago sa background. Sa karamihan ng modernong Linux setup (Hyprland, sway, GNOME, KDE), kailangan dito ang libayatana-appindicator3 library at isang panel o bar na nagpapakita ng tray icons.

1. I-install ang library:

# 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. Siguraduhing may tray host ang desktop mo:

  • KDE Plasma, XFCE, MATE, Cinnamon, LXQt, Budgie: built-in na, wala ka nang gagawin.
  • GNOME: i-install ang AppIndicator Support extension (marami ring tiling extension ng GNOME ang may tray support).
  • Hyprland / sway / river / Niri: i-enable ang tray module sa waybar, o gumamit ng panel gaya ng nwg-panel.

Pagkatapos mag-install, i-restart ang GameVox. Dapat makita sa log ang [Tray] AppIndicator (StatusNotifierItem) created. Kung "your desktop environment does not support GtkStatusIcon" pa rin ang lumalabas, hindi nahahanap ang library. I-check kung naka-install ito gamit ang ldconfig -p | grep ayatana.

Mga display issue sa Wayland

Sa mga Wayland session, pinipilit ng GameVox ang X11 backend gamit ang XWayland para maiwasan ang input issues sa mga frameless window sa tiling window managers (Sway, Hyprland, Niri). Kung may display problems ka, siguraduhing naka-install ang XWayland.

Hindi gumagana ang screen share audio

Gumagamit ang screen share audio ng per-window capture mula sa browser engine. Siguraduhing tumatakbo ang PipeWire (o PulseAudio). Sa ilang Wayland compositor, baka kailangan mong magbigay ng screen capture permission sa XDG Desktop Portal.