Arch Linux

Install the host on Arch Linux and Arch-based distros such as CachyOS and EndeavourOS. Omarchy and SteamOS have their own pages: Omarchy, SteamOS.

One command instead? The guided installer (preview) does steps 2 to 4 and warns when step 1 is missing:

curl -fsSL https://punktfunk.unom.io/install.sh | sh

1. GPU driverCopy Anchor Link

• NVIDIA: sudo pacman -S --needed nvidia-utils. NVENC comes from it.
• AMD / Intel: the Mesa stack a desktop usually has already: vulkan-radeon or vulkan-intel for Vulkan Video, libva-mesa-driver or intel-media-driver for VAAPI.

2. Install the hostCopy Anchor Link

Trust the repo key, add the repo, and install the host, the console and the plugin runner. Always use a full -Syu: the packages are built against current Arch libraries, and a partial upgrade breaks them.

curl -fsS https://git.unom.io/api/packages/unom/arch/repository.key | sudo pacman-key --add -sudo pacman-key --lsign-key E0CA04465C99C936E0B0C6510A317015A34DDD69grep -q '^\[punktfunk\]' /etc/pacman.conf || printf '\n[punktfunk]\nServer = https://git.unom.io/api/packages/unom/arch/$repo/$arch\n' | sudo tee -a /etc/pacman.conf >/dev/nullsudo pacman -Syu punktfunk-host punktfunk-web punktfunk-scripting

sudo pacman -Syu updates every Punktfunk package from then on. Restart the console and the host afterwards with systemctl --user restart punktfunk-web punktfunk-host, or let the console update it. The host also installs punktfunk-gamescope (HDR on gamescope). The repo carries punktfunk-client too.

3. Let it use your controllersCopy Anchor Link

Join the groups, then log out and back in:

sudo usermod -aG input "$USER"       # virtual gamepads
sudo usermod -aG punktfunk "$USER"   # virtual Steam Deck controller

4. Start itCopy Anchor Link

From a terminal inside your desktop session. On Arch the plugin runner isn't started for you:

systemctl --user enable --now punktfunk-host punktfunk-web punktfunk-scripting

Stock Arch has no firewall. CachyOS enables ufw and EndeavourOS enables firewalld; open the host, and the console for other devices:

# ufw (CachyOS)
sudo ufw allow punktfunk-native && sudo ufw allow punktfunk-web
# firewalld (EndeavourOS)
sudo firewall-cmd --reload
sudo firewall-cmd --permanent --add-service=punktfunk-native --add-service=punktfunk-web
sudo firewall-cmd --reload

Next: Quick Start, step 3: open the console and pair a device.

MoreCopy Anchor Link

• pacman says database already registered? The repo was added twice: the fix.
• Your desktop: KDE, GNOME, gamescope, Hyprland, Sway.
• Stream with nobody logged in: Running as a service.
• Build the packages yourself: Build from source.