This user guide is meant to be the main provider of support for QGroundControl. If you find incorrect or missing information please report an Issue.
Questions about how to use QGroundControl should be raised in the discussion forum for the associated flight stack:
These forums are also the best place to start discussions on bugs/problems you are having with QGroundControl and or feature requests you would like to make. From there you may be directed to entering information in a GitHub Issue for further resolution.
QGroundControl developers (and many regular/deeply-involved users) can be found on the #QGroundControl Slack channel.
Issues are used to track bugs against QGroundControl as well as feature requests for later versions. The current list of issues can be found on GitHub here.
Please contact our developers using the support forums before creating GitHub issues for either bugs or feature requests.
If you are directed to create an issue, please use the "Bug report" template and provide all information specified in the template.
Reporting Crashes from Windows Builds
When QGC crashes a crash dump file will be place in the Users LocalAppData directory. To navigate to that directory use the Start/Run command. You can bring this up window WinKey+R. Type into that
%localappdata% for Open and click Ok. Crash dumps will be in a
QGCCrashDumps folder in that directory. You should find a new .dmp file there. Add a link to that file in a GitHub Issue when reporting you problem.
Reporting Hangs from Windows Builds
If Windows is telling you the QGroundControl program is unresponsive use the following steps to report the hang:
- Open Task Manager (right-click TaskBar, select Task Manager)
- Switch to the Processes tab and local qgroundcontrol.exe
- Right-click on groundcontrol.exe and select Create Dump File
- Place the dump file in a public location
- Add a link to the .dmp file and above details in the GitHub issue.
If you are directed to create a feature request after discussion on support forums please use the "Feature request" template which has some helpful information on required details.
Troubleshooting information is provided in two topics:
- QGC Installation/Configuration Problems - problems/solutions related to running QGroundControl on the host computer.
- QGC/Vehicle Interaction Problems - problems/solutions related to using QGroundControl to interact with a vehicle.
Console Logs can be helpful when diagnosing QGroundControl problems. For more information see: Console Logging.
Help Improve these Docs!
Just like QGroundControl itself, the user guide is an open source, user created and supported GitBook. We welcome Pull Requests against the guide for fixes and/or updates.