enricobuehlerandClaude Opus 5
d383161723
~1150 feat/fix commits landed since v0.19 and the docs drifted badly. This is a full sweep of every page against the code as shipped: ~280 verified corrections, nine new pages, and one deletion. The worst of what was wrong: the quickstart's five-minute path could not work (`serve` never started the web console, so step 3 had no PIN to read); every packaged Linux host runs `serve --gamestream` while security.md told readers to leave GameStream off; HDR was documented as Windows-only; `PUNKTFUNK_SECURE_DDA` was documented as a working knob that nothing reads; `PUNKTFUNK_INPUT_BACKEND` listed a `uinput` value that does not exist and named libei for KDE instead of kwin; README linked three pages deleted on 2026-07-05; and the rpm-ostree update command pointed at a script no package installs. Completeness: about half of what shipped since v0.19 had no page at all. New: support-matrix (what works where, from 217 verified capability cells), input (mouse/touch/pen — and the in-stream chords, so the docs finally say how to get your mouse back), client-settings, profiles-and-links, game-library, clipboard, wake-on-lan, hdr, uninstall. Updating existed but had zero inbound links. status.md is gone: its facts moved into the support matrix, its shell stays as a redirect so the public URL does not 404. roadmap.md is themes now, not a feature checklist — checkboxes are what rotted. Debian is no longer claimed. The .deb's Depends resolve against Ubuntu images, nothing in CI builds or tests Debian, and Debian 12 is below the glibc 2.39 floor. The `debian` in the repo URL is the package format. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
3.6 KiB
title, description
| title | description |
|---|---|
| Forgot your Password? | Where the Punktfunk web console login password lives — and how to read or reset it — on each host platform. |
The Punktfunk web console (status, paired devices, PIN pairing) is protected by a login password. That password is generated — or, on Windows, chosen — when the console is first set up, and it lives on the host. So if you can't get past the login screen, you recover or change it on the host machine itself, not from the browser.
New to the console? See The Web Console to enable it and arm pairing.
This is only the web console login. It is not your client/device pairing — if a client won't connect, that's Pairing, not this password.
Find your host
Find your host platform for exactly where the password lives, then read it back or change it below:
| Host | Where the password lives | Section |
|---|---|---|
| Linux packages (apt / RPM / Arch / Bazzite / NixOS) | ~/.config/punktfunk/web-password |
Login password |
| SteamOS (host) | ~/.config/punktfunk/web.env |
Login password |
| Windows host | %ProgramData%\punktfunk\web-password |
Login password · Windows Host |
Read it back, or set your own
The password is stored on the host as a PUNKTFUNK_UI_PASSWORD=… line, so you can read it straight
out of the file. On the Linux packages and the SteamOS host:
sed -n 's/^PUNKTFUNK_UI_PASSWORD=//p' ~/.config/punktfunk/web-password # Linux packages
sed -n 's/^PUNKTFUNK_UI_PASSWORD=//p' ~/.config/punktfunk/web.env # SteamOS host
On a Windows host, from an elevated PowerShell (the file is readable only by Administrators and SYSTEM):
Get-Content "$env:ProgramData\punktfunk\web-password"
To replace it with one you pick, follow Login password. It has the exact edit-and-restart steps for each of the three platforms above, and it's the one place that procedure is kept up to date.
The password is right and it still won't let you in
The login screen says "Wrong password." for every failure, including two that have nothing to do with the password you typed.
-
Too many attempts. Five wrong guesses from the same device are free; every one after that arms a lockout that doubles — a second, two, four — up to five minutes. While it holds, even the correct password is refused. Wait it out, or clear it at once by restarting the console (the lockout is only kept in the console's memory):
systemctl --user restart punktfunk-webschtasks /End /TN PunktfunkWeb; schtasks /Run /TN PunktfunkWeb(The PowerShell one is Windows, from an elevated prompt.)
-
No password is configured at all. If the file is missing or empty, or a line lost its
PUNKTFUNK_UI_PASSWORD=prefix, the console fails closed and admits nobody — a page you open answersauth not configured: set PUNKTFUNK_UI_PASSWORD. Put the line back —PUNKTFUNK_UI_PASSWORD=<your-password>, on its own line, nothing else on it — and restart the console as above. On the Linux packages you can instead delete~/.config/punktfunk/web-passwordand runsystemctl --user restart punktfunk-web-init punktfunk-webwhich generates a fresh password, prints it to the journal, and starts the console with it — read it back with the command above.
Still stuck? See Troubleshooting.