The Web Console
Open the Punktfunk web console, sign in, arm pairing, and find your way around its pages.
The web console is where you run your host from a browser: pairing, displays, the game library, settings, logs and plugins.
A streaming host is remote control of the machine. Read Security & Safe Use first, and keep the host on a trusted LAN or VPN.
Open the console
Browse to https://<host-ip>:47992 and accept the certificate warning once. The certificate
is the host's own self-signed identity.
The guided installer, the Windows installer and the SteamOS script start the console for you. A Linux host installed by hand needs it enabled as your desktop user:
systemctl --user enable --now punktfunk-webUnit not found means the console package is missing:
install it.
The console answers devices on your local network or a VPN and refuses the internet. To keep it to
the host machine, set PUNKTFUNK_UI_BIND=127.0.0.1 in host.env
(Configuration) and restart the console.
Two ports, not one
Plugin interfaces are served on TCP 47993, a separate origin, so plugin code can't act with your console login.
- Open 47992 and 47993 on the host's firewall. The packaged
punktfunk-webfirewall profile lists both. - Your browser trusts the certificate per port. The first time you open a plugin, the console shows Trust this plugin's port once: click Open in a new tab, accept the warning, and come back.
An empty plugin panel: see A plugin's interface doesn't load.
Login password
The guided installer asks whether to generate a password or take yours, and the Windows wizard shows its password on the last page. A silent or winget install shows nothing.
The password file is readable only until your first sign-in; the console then keeps a salted hash. To read it before that, or reset it after, see Forgot your Password?.
Arm pairing
The host requires PIN pairing. Open Devices → Pair a device, and enter the 4-digit PIN it shows on your client. A device that already tried to connect waits under Waiting for approval; Approve pairs it without a PIN. Pairing & Trust covers access levels and removing devices.
The pages
The sidebar holds six pages, then a Manage group. On a phone the bar holds Home, Profiles,
Devices and Library; More holds the rest, and a row's buttons fold into its ⋯. Each page's
address is its place in the sidebar:
Devices is /devices, Diagnostics → Performance is /diagnostics/performance.
| Page | What you do there |
|---|---|
| Home | Three sections. Attention: health warnings, devices waiting for approval, an audio endpoint that isn't ready. Now: one row per session on every desktop, a seat that is starting, and a game left running without a stream; Stop ends a session; beside it, request a keyframe, mute it, or change its access level or player number, and Details holds the stream's numbers. With nothing live, the last session in one line. Recent: what the host did lately; Show all expands it. With more than one profile, a row starts with the player's picture and name. |
| Profiles | Who plays on this host: one card per profile with where it plays and when it last did. Add a profile that shares your desktop or has a desktop of its own. Rename, change the picture, or remove one; removing asks for the console password. |
| Devices | One list: devices waiting for approval first, then every paired device with its access, display settings and whether it is streaming. Pair a device shows a PIN; with GameStream on, its second step takes a Moonlight client's PIN. A row edits access or display settings, renames a Moonlight device, or unpairs. Approving shows the profile a device asks to play as. |
| Displays | What happens to your screens when a device connects: the map with a ghost of the next device's screen, Screens (every monitor and streamed screen, with Release on a kept one), the presets, and Advanced. With seats on, Other desktops lists each seat's desktop. See Virtual displays. |
| Library | Turn game sources on or off, add or edit a custom title. See Your game library. |
| Host | One page. On top, the host's name, version and whether it is current, with Check for update and power in ⋯; the address and deep link for a new device; and Details (identity, codecs, ports, compositors, audio wiring). Below, the settings, one group per tab, with search across every group and Advanced (Configuration): GPU choice is a row of Video, what a game's exit and a session's end do are rows of Session, and Seats holds what every seat shares. Updates and host power unfold when there is one to act on. A setting pinned in host.env shows as locked. |
| Diagnostics | Three tools for when something is off. Troubleshooting: health checks above the live log of the host, your plugins, each running seat and the logs clients sent; Export all saves one file for a bug report. Performance: record a capture and read per-stage latency, throughput and drops (Recording a capture). Controllers: the controllers the host holds for a live session, lit by what it receives. |
| Automation | Run a command or call a webhook when the host does something, for every device or one device, game or profile. See Events & hooks. |
| Plugins | Browse, Installed and Sources, plus the plugin runner switch. See Plugins. |
| Settings | Language, appearance, sign out, and which plugin pages get their own sidebar entry. |
Understanding the Stats Overlay
What every number in the stats overlay means, in the Standard and Advanced views, and how the Standard view lines up with Moonlight's.
Virtual displays
Choose what happens to your screens when a device connects — presets, keep-alive, your monitors, per-device settings and game sessions.