enricobuehler
30d0d36efe
Plugin self-update (no Decky store): CI publishes a per-channel manifest.json
({version, immutable per-version artifact, sha256}) beside the zip and bakes
update.json {channel, manifest} into the plugin. main.py `check_update` reads the
installed version from package.json (the value Decky reports — not plugin.json),
fetches the channel manifest, and the frontend shows an "Update to vX" button that
drives Decky Loader's own install RPC (root downloads + SHA-256-verifies + hot-reloads).
CI now stamps a plain-numeric semver (0.3.<run> canary / X.Y.Z stable) into
package.json — a -ciN suffix would mis-order under compare-versions.
Linux client: `--fullscreen` (plus SteamDeck/gamescope env fallback) enters GTK
fullscreen on stream start so Gaming-Mode chrome is hidden; native-mode resolution
falls back to the display's first monitor when the window isn't mapped yet (was
dropping to the 1080p floor — wrong on the Deck's 1280×800); add a confirmed
"Remove saved host" action (KnownHosts::remove_by_fp).
Docs: new docs/steam-deck.md (Decky install/pair/stream/self-update/troubleshooting),
wired into meta.json nav, and cross-linked from clients/install-client/channels. This
is the page docs.punktfunk.unom.io/docs/steam-deck — the website's download link
pointed at it before it existed; committing it makes that link resolve.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
6.7 KiB
title, description
| title | description |
|---|---|
| Install a Client | Install the punktfunk client for the device you're streaming to — Linux, Steam Deck, Windows, macOS, iOS, or Android. |
This page is the install path for each client device. For what each client is and which to pick, see Clients; to install the host, see Install the Host. Whichever client you install, the first connection needs a one-time pairing.
The links below are the stable channel (moves on
vX.Y.Zreleases). For the latestmainbuild, use the canary channel — TestFlight / Play Internal, the…Canary.flatpakref, or thecanary/download URLs. See Release Channels.
Pick your device
| Device | Install |
|---|---|
| Linux desktop / laptop | Flatpak (any distro) or native apt/rpm/Arch packages |
| Steam Deck | Decky plugin for Gaming Mode, or Flatpak in Desktop Mode |
| Windows | Signed MSIX from the package registry |
| macOS | Notarized .dmg from the releases page |
| iPhone / iPad / Apple TV | TestFlight beta |
| Android / Android TV | Beta — request access |
| Anything else (browser, old phone, TV) | Moonlight |
Linux desktop (Flatpak)
The recommended path on any Flatpak distro — install once, then flatpak update tracks new
builds. One command adds the signed unom remote, pulls the GNOME runtime from Flathub
automatically, and installs the client:
flatpak install --user https://flatpak.unom.io/io.unom.Punktfunk.flatpakref
flatpak run io.unom.Punktfunk
Updates, from then on:
flatpak update # or: flatpak update io.unom.Punktfunk
Prefer your native package manager? The client also ships as real packages (add the repo once —
see the linked guide — then it tracks updates with your normal apt upgrade / rpm-ostree upgrade):
| Distro | Install | Guide |
|---|---|---|
| Ubuntu / Debian | sudo apt install punktfunk-client |
packaging/debian |
| Fedora / Bazzite | rpm-ostree install punktfunk-client |
packaging/rpm |
| Arch / SteamOS | punktfunk-client from the PKGBUILD |
packaging/arch |
Then launch it, pick your host from the list, and stream. For scripting, skip the picker:
punktfunk-client --connect <host>:9777
Steam Deck
Most Deck users want Gaming Mode: install the Decky plugin and a punktfunk panel lands in the Quick Access Menu, so you can discover hosts, pair with a PIN, and stream without dropping to the desktop. Follow the Steam Deck (Decky) guide — it walks through Decky Loader, the plugin, and the one-time client install.
The plugin doesn't decode video itself — it launches the Flatpak client below. The Decky guide covers installing both, so start there: a Flatpak on its own won't add the Gaming Mode panel.
For Desktop Mode (or to add the client to Game Mode as a non-Steam app yourself), install the Flatpak exactly as above — it carries its own libadwaita + SDL3 and survives SteamOS updates:
flatpak install --user https://flatpak.unom.io/io.unom.Punktfunk.flatpakref
See packaging/flatpak.
Windows
The Windows client ships as a signed MSIX in the package registry. Builds use a self-signed certificate, so you import that certificate once before Windows will install the package.
-
Open the packages page (generic group), find
punktfunk-client-windows, and download the newest.msixand its matching.cer. -
Trust the publisher certificate, then install. The MSIX won't install until the certificate is trusted — but it's the same certificate for every release, so this is genuinely one-time and later updates need nothing. In an admin PowerShell:
Import-Certificate -FilePath .\punktfunk-client-windows.cer ` -CertStoreLocation Cert:\LocalMachine\TrustedPeople Add-AppxPackage .\punktfunk-client-windows.msixIf Windows reports a missing dependency, install the Windows App Runtime 2.x (the MSIX depends on
Microsoft.WindowsAppRuntime.2), then re-runAdd-AppxPackage. -
Launch Punktfunk from the Start menu and pick your host.
The Windows client's hardware-decode (D3D11VA) and HDR paths are complete but still pending validation on real GPU hardware. If anything misbehaves, Moonlight is a solid alternative for Windows.
macOS
Download the notarized disk image from the releases page
— Punktfunk-<version>.dmg. It's Developer-ID signed, notarized, and stapled, so Gatekeeper opens
it without warnings:
- Open
Punktfunk-<version>.dmgand drag Punktfunk to Applications. - Launch it, pick your host from On this network, and pair.
The Mac app is also in the TestFlight beta; the DMG is the no-account path.
iOS, iPadOS, Apple TV
The Apple app is in TestFlight beta — one universal build covers iPhone, iPad, Apple TV, and the Mac. Install Apple's TestFlight app, then join:
Join the punktfunk beta on TestFlight →
Open the app, and your hosts appear automatically under On this network.
Android
The Android client (phone + Android TV) is in Google Play Internal Testing. To try it, request a tester invite on our Discord and we'll add your Google account to the test track:
Once you're added, install it from Google Play, then open the app and pick your host:
Get punktfunk on Google Play → (only resolves once your account is on the tester list)
Anything else — Moonlight
Any device with a Moonlight client (browser, old phone, smart TV) connects over GameStream with no punktfunk-specific software. See Connect with Moonlight.