Awesome
Emuflight Configurator
Emuflight Configurator is a crossplatform configuration tool for the Emuflight flight control system.
Various types of aircraft are supported by the tool and by Emuflight
- quadcopters
- hexacopters
- octocopters
- fixed-wing aircraft.
The application allows you to configure the Emuflight software running on any supported Emuflight target.
Downloads
Please download our releases at GitHub.
Authors
Emuflight Configurator is a fork of the Cleanflight Configurator with support for Emuflight instead of Cleanflight.
This configurator is the only configurator with support for Emuflight specific features!
If you are experiencing any problems please make sure you are running the latest firmware version.
Installation
Standalone
This is the default installation method, and at some point in the future this will become the only way available for most platforms. Please use this method whenever possible.
Please download the installer from the Release page.
Apple OSX/Mac
The application is signed and built on a secure environment but we are still working on notarization to get accepted on the Apple Store.
In the meantime, please right-click
the application and select Open
to be able to override the strict security restrictions.
Experimental Test Builds
Automated Builds available to try on your own risk!
Development
Setup
- Install Node.js
- Install yarn:
npm install yarn -g
- Change to project folder and run:
yarn install
- Run
yarn start
Run Tests
yarn test
Build and Release
The tasks are defined in gulpfile.js
and can be run with through yarn:
yarn gulp <taskname> [[platform] [platform] ...]
Available Tasks
List of possible values of <task-name>
:
- dist copies all the JS and CSS files in the
./dist
folder - apps builds the apps in the
./apps
folder [1] - debug builds debug version of the apps in the
./debug
folder [1] - release zips up the apps into individual archives in the
./release
folder [1]
Build or release app for one specific platform
To build or release only for one specific platform you can append the plaform after the task-name
.
If no platform is provided, all the platforms will be done in sequence.
- MacOS use
yarn gulp <task-name> --osx64
- Linux use
yarn gulp <task-name> --linux64
- Windows use
yarn gulp <task-name> --win32
- ChromeOS use
yarn gulp <task-name> --chromeos
You can also use multiple platforms e.g. yarn gulp <taskname> --osx64 --linux64
.
Languages
Emuflight Configurator has been translated into several languages.
The application will try to detect and use your system language if a translation into this language is available.
If you prefer to have the application in English or any other language, you can select your desired language in the options menu of the application.
Notes
WebGL
Make sure Settings -> System -> Use hardware acceleration when available
is checked to achieve the best performance
Linux users
Please add your user into the dialout
group for serial access:
sudo usermod -aG dialout $USER
Linux / MacOSX users
If you have 3D model animation problems, enable "Override software rendering list" in Chrome flags at
chrome://flags/#ignore-gpu-blacklist
Support
If you need help please reach out in Emuflight support chat on Discord before raising issues on Github.
Please register and join via this link.
Issue trackers
- For Emuflight configurator issues raise them at https://github.com/emuflight/EmuConfigurator/issues
- For Emuflight firmware issues raise them at https://github.com/emuflight/EmuFlight/issues
Thank you!
Developers
We accept clean and reasonable patches, please submit them!