Files
punktfunk/docs-site/content/docs/install-client.md
T
enricobuehler 844f4b86bd
apple / swift (push) Successful in 54s
android / android (push) Failing after 2m1s
ci / rust (push) Successful in 1m38s
rpm / build-publish (bazzite, punktfunk-fedora-rpm) (push) Has been cancelled
rpm / build-publish (fedora-44, punktfunk-fedora44-rpm) (push) Has been cancelled
ci / web (push) Successful in 31s
ci / docs-site (push) Successful in 29s
deb / build-publish (push) Successful in 2m36s
decky / build-publish (push) Successful in 25s
ci / bench (push) Successful in 4m31s
docker / build-push (., web/Dockerfile, punktfunk-web) (push) Successful in 17s
docker / build-push (--build-arg FEDORA_VERSION=44, ci, ci/fedora-rpm.Dockerfile, punktfunk-fedora44-rpm) (push) Successful in 2m48s
docker / build-push (ci, ci/fedora-rpm.Dockerfile, punktfunk-fedora-rpm) (push) Successful in 2m34s
docker / build-push (docs-site, docs-site/Dockerfile, punktfunk-docs) (push) Successful in 23s
docker / build-push (ci, ci/rust-ci.Dockerfile, punktfunk-rust-ci) (push) Successful in 2m21s
docker / deploy-docs (push) Successful in 22s
docs: add an "Install a Client" page covering every client + install path
Per-device install steps in one place: Linux (Flatpak via flatpak.unom.io +
native apt/rpm/Arch), Steam Deck, Windows (signed MSIX from the registry),
macOS (notarized DMG from releases), and iOS/Android (store/beta links). Adds
it to the Connecting nav and cross-links clients.md, whose Linux/Flatpak bullet
now points at the hosted flatpak.unom.io repo instead of the bundle README.

Mobile store/TestFlight URLs are placeholders pending the public listings.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 22:02:02 +00:00

5.5 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.

Pick your device

Device Install
Linux desktop / laptop Flatpak (any distro) or native apt/rpm/Arch packages
Steam Deck Flatpak in Desktop Mode (or the Decky plugin)
Windows Signed MSIX from the package registry
macOS Notarized .dmg from the releases page
iPhone / iPad / Apple TV App Store / TestFlight
Android / Android TV Google Play
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

In Desktop Mode, 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

Add it to Game Mode as a non-Steam app, or use the Decky plugin, which launches this same Flatpak (flatpak run io.unom.Punktfunk --connect …). 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.

  1. Open the packages page (generic group), find punktfunk-client-windows, and download the newest .msix and its matching .cer.

  2. In an admin PowerShell, trust the publisher certificate (one-time), then install:

    Import-Certificate -FilePath .\punktfunk-client-windows.cer `
      -CertStoreLocation Cert:\LocalMachine\TrustedPeople
    Add-AppxPackage .\punktfunk-client-windows.msix
    

    If Windows reports a missing dependency, install the Windows App Runtime 2.x (the MSIX depends on Microsoft.WindowsAppRuntime.2), then re-run Add-AppxPackage.

  3. Launch Punktfunk from the Start menu and pick your host.

The Windows client is young (software decode; hardware D3D11VA/HDR in progress). If it misbehaves, Moonlight is a solid alternative for Windows.

macOS

Download the notarized disk image from the releases pagePunktfunk-<version>.dmg. It's Developer-ID signed, notarized, and stapled, so Gatekeeper opens it without warnings:

  1. Open Punktfunk-<version>.dmg and drag Punktfunk to Applications.
  2. Launch it, pick your host from On this network, and pair.

The Mac app is also part of the TestFlight beta (see below); the DMG is the no-account path.

iOS, iPadOS, Apple TV

The Apple app is a universal purchase — one App Store listing covers iPhone, iPad, Apple TV, and the Mac. It's currently distributed through TestFlight while in beta.

  • App Store: coming soonlisting
  • TestFlight (beta): join link pending

Install, open the app, and your hosts appear automatically under On this network.

Android

The Android client (phone + Android TV) is on Google Play, currently in closed testing.

  • Google Play: listing (closed testing — request access)

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.