86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
# Betaflight Configurator
|
|
|
|
|
|
|
|
Betaflight Configurator is a crossplatform configuration tool for the Betaflight flight control system.
|
|
|
|
It runs as an app within Google Chrome and allows you to configure the Betaflight software running on any [supported Betaflight target](https://github.com/betaflight/betaflight/tree/master/src/main/target).
|
|
|
|
Various types of aircraft are supported by the tool and by Betaflight, e.g. quadcopters, hexacopters, octocopters and fixed-wing aircraft.
|
|
|
|
## Authors
|
|
|
|
Betaflight Configurator is a [fork](#credits) of the Cleanflight Configurator with support for Betaflight instead of Cleanflight.
|
|
|
|
This configurator is the only configurator with support for Betaflight specific features. It will likely require that you run the latest firmware on the flight controller.
|
|
If you are experiencing any problems please make sure you are running the [latest firmware version](https://github.com/betaflight/betaflight/releases/).
|
|
|
|
## Installation
|
|
|
|
### Via chrome webstore
|
|
|
|
[](https://chrome.google.com/webstore/detail/betaflight-configurator/kdaghagfopacdngbohiknlhcocjccjao)
|
|
|
|
1. Visit [Chrome web store](https://chrome.google.com/webstore/detail/betaflight-configurator/kdaghagfopacdngbohiknlhcocjccjao)
|
|
2. Click **+ Add to Chrome**
|
|
|
|
Please note - the application will automatically update itself when new versions are released. Please ensure you maintain configuration backups as described in the Betaflight documentation.
|
|
|
|
### Alternative way
|
|
|
|
1. Clone the repo to any local directory or download it as zip.
|
|
2. Extract to a folder and not the folder.
|
|
3. Start Google Chrome.
|
|
4. Click the 3-dots on the far right of the URL bar.
|
|
5. Select "More Tools"
|
|
6. Select "Extensions"
|
|
7. Check the Developer Mode checkbox.
|
|
8. Click on load unpacked extension.
|
|
9. Point it to the folder you extracted the zip to.
|
|
|
|
## How to use
|
|
|
|
You can find the Betaflight Configurator icon in your application tab "Apps"
|
|
|
|
## Notes
|
|
|
|
### WebGL
|
|
|
|
Make sure Settings -> System -> "User hardware acceleration when available" is checked to achieve the best performance
|
|
|
|
### Linux users
|
|
|
|
Dont forget to add your user into dialout group "sudo usermod -aG dialout YOUR_USERNAME" for serial access
|
|
|
|
### Linux / MacOSX users
|
|
|
|
If you have 3D model animation problems, enable "Override software rendering list" in Chrome flags chrome://flags/#ignore-gpu-blacklist
|
|
|
|
## Support
|
|
|
|
If you need help please reach out on the [betaflightgroup](https://betaflightgroup.slack.com) slack channel before raising issues on github. Register and [request slack access here](http://www.betaflight.tk).
|
|
|
|
### Issue trackers
|
|
|
|
For Betaflight configurator issues raise them here
|
|
|
|
https://github.com/betaflight/betaflight-configurator/issues
|
|
|
|
For Betaflight firmware issues raise them here
|
|
|
|
https://github.com/betaflight/betaflight/issues
|
|
|
|
## Technical details
|
|
|
|
The configurator is based on chrome.serial API running on Google Chrome/Chromium core.
|
|
|
|
## Developers
|
|
|
|
We accept clean and reasonable patches, submit them!
|
|
|
|
## Credits
|
|
|
|
ctn - primary author and maintainer of Baseflight Configurator from which Cleanflight Configurator project was forked.
|
|
|
|
Hydra - author and maintainer of Cleanflight Configurator from which this project was forked.
|