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.
A good report is one file with the host's log, its health checks and your client's log. Two clicks build it.
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
Open the host's menu and pick Send logs to host. No stream needs to be running.
| Client | Where |
|---|---|
| Linux, Windows, Android | The host card's menu |
| iPhone, iPad, Mac, Apple TV | Long-press (or right-click) the host card → Send Logs to Host |
| Gamepad console (Steam Deck Gaming Mode, couch mode, controller home) | 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 TCP port 47990 is blocked — see Ports, or grab the log by hand.
3. Export everything from the web console
Open the web console, pick Troubleshooting in the sidebar, and press
Export all. You get one text file, punktfunk-diagnostics-YYYYMMDD-HHMMSS.txt, with the health
checks, the whole 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 issue
Open an issue at git.unom.io/unom/punktfunk/issues, or ask on Discord first. 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\ 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 to standard output |
These follow RUST_LOG (info by default), so they hold less than the uploads above.
Audio
Streamed audio stutters, sounds worse than the host, or lags behind the picture — and the host-side endpoint and quality knobs.
Why do I hear myself
Echo while streaming — the four places it can come from (client speakers, Windows monitoring loops, host speakers, virtual mixers) and how to stop each one.