Reporting an Issue
Send a client's log to its host, export everything as one file from the web console, and attach it to a bug report.
Build one file with the host's log, its health checks and your client's log, and attach it to a bug report.
Security problem? Don't open a public issue — email security@punktfunk.com (SECURITY.md).
1. Reproduce it, and keep the app open
The client keeps its log in memory and loses it when you quit. Send it from the same app run that saw the problem, and note roughly when it happened.
2. Send the client's log to the host
No stream needs to be running.
| Client | Where |
|---|---|
| Linux, Windows, Android | The host card's menu → Send logs to host |
| iPhone, iPad, Mac, Apple TV | Long-press (or right-click) the host card → Host details… → Send logs to host |
| Console home (Steam Deck Gaming Mode, TV, controller) | The host's options → Send logs to host |
The item shows only for a paired host that is online (Apple: paired is enough). It sends the newest 4096 lines at debug detail. If the upload fails, the host's management port (TCP 47990) is blocked — see Ports, or grab the log by hand.
3. Export everything from the web console
In the web console, open Diagnostics → Troubleshooting and press
Export all. You get one text file, punktfunk-diagnostics-YYYYMMDD-HHMMSS.txt, with the health
checks, the host and plugin log, and every client log the host holds.
Read it before you post it. Nothing is redacted: it holds host names, IP addresses and device names.
4. File the report
Report it on improve unom, where you can also
vote for bugs that hit you too and follow what happens to yours. You need a free unom account. It
takes text only, so paste the parts of the export that matter. Or post in the bug-reports forum on
Discord and attach the export there.
Either way the title and text of your report are public, on improve unom and on our tracker, so keep host names and addresses out of them. Include:
- host and client versions (the console's Host page; the first line of each client log)
- host OS and desktop, GPU, the client device, wired or Wi-Fi
- what you did, what you expected, what happened, and when
- the export from step 3
For stutter or lag, add a performance recording.
Logs without the console
| Where | How |
|---|---|
| Linux host | journalctl --user -u punktfunk-host |
| Windows host | %ProgramData%\punktfunk\logs\ (host.log, service.log, web.log) from an elevated PowerShell |
| Windows client | Settings → About → Diagnostics → Open log folder |
| Mac, iPhone, iPad | Console.app on a Mac, subsystem io.unom.punktfunk |
| Android | adb logcat, tag punktfunk |
| Linux client | Start it from a terminal; it logs there |
These follow RUST_LOG (info by default), so they hold less than the uploads above, which keep
debug detail.