Reporting a problem¶
Found a bug, or something not working as described? Reports are very welcome — a good one gets it fixed much faster. Kite is developed openly on GitHub:
Before you file¶
- Check the troubleshooting pages — many common snags are covered under Connection and Video.
- Search existing issues. Someone may have already reported it; adding your details to an open issue is more useful than a duplicate. If it's there, a 👍 or a comment with your specifics helps.
- Try to reproduce it. A problem you can trigger on demand is far easier to fix than a one-off.
What to include¶
The more of this you provide, the quicker it can be diagnosed:
- A clear description — what went wrong, in one or two sentences.
- Expected vs. actual — what you thought would happen, and what actually did.
- Steps to reproduce — numbered, from a known starting point, so someone else can follow them:
- Your environment:
- Kite version (shown in the top bar, and under About in Settings).
- Operating system and version (Windows / Linux, and which).
- Autopilot and firmware version — INAV / ArduPilot / PX4 and the exact version.
- Connection type — USB serial, Bluetooth (SPP / BLE), TCP or UDP.
- Screenshots or a short screen recording — especially for anything visual (map, widgets, 3D).
- The diagnostic log — see below.
Attach a diagnostic log¶
The log usually pinpoints the cause. To capture a good one:
- Open Settings → Diagnostics and set Log Level to Debug.
- Reproduce the problem.
- Click Open Log Folder and attach the log file to the issue.
The log locations and what the file contains (port names and firmware strings, but no personal data) are listed under Connection → Getting a diagnostic log.
One problem per issue
If you've hit several unrelated things, file them separately — each gets tracked and fixed on its own.