Emuflight Configurator

Emuflight Configurator is a crossplatform configuration tool for the Emuflight flight control system.

!Emuflight

Supports quadcopters, hexacopters, octocopters, and fixed-wing aircraft. Configure any supported Emuflight target.

Downloads

Please download our releases at GitHub.

Installation

Download the installer for your platform from the Releases page.

macOS: Right-click the app and select Open to bypass Gatekeeper on first launch.

Support

• Emuflight Discord
• Configurator issues
• Firmware issues

Development

Requirements

1. Node.js (LTS recommended)
2. nvm (Node version manager; optional but recommended for reproducible local Node versions)
3. Yarn (npm install -g yarn)

Commands

| Command | Description | |---------|-------------| | yarn dev | Start dev mode with devtools | | yarn debug | Alias for yarn dev | | yarn build | Build dist/ only | | yarn make | Create release packages (all platforms) | | yarn make:dev | Alias for yarn make:debug | | yarn make:debug | Create debug packages with the DevTools menu enabled | | yarn package | Build an unpacked application package | | yarn package:debug | Build an unpacked debug package | | yarn commands | Show the available project commands | | yarn lint | Run ESLint | | yarn setup:hooks | Install git pre-commit hook (enforces lint checks) |

Git Hooks

EmuConfigurator enforces code quality with automatic git commit hooks. Before each commit, yarn lint runs automatically — commits with lint errors are blocked (warnings OK).

Setup (first time):

yarn setup:hooks

This works on all platforms (Windows, macOS, Linux).

After setup:

• Commits are checked automatically
• Lint errors block commits
• Run yarn lint -- --fix to auto-fix issues
• Use git commit --no-verify to bypass (emergency only)

Build Output

• dist/ — assembled app sources
• out/make/ — packaged applications and installers

• macOS: ZIP always, DMG local only (requires macos-alias)
• Windows: EXE installer
• Linux: DEB + RPM

macOS DMG Building

CI (GitHub Actions): Builds ZIP only (portable, suitable for distribution)

Local Dev: To build DMG locally (macOS only):

brew install macos-alias   # One-time install
yarn make                   # Builds both .zip and .dmg

DMG is skipped in CI because macos-alias (native module) doesn't cross-compile reliably. ZIP is portable and sufficient for most use cases.

Platform Notes

Linux: Serial Port Access

sudo usermod -aG dialout $USER
Log out and back in

Linux: USB DFU Flashing

Create /etc/udev/rules.d/49-stm32dfu.rules:

SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", \
MODE="0664", GROUP="plugdev"

Then: sudo udevadm control --reload-rules && sudo udevadm trigger

!Emuflight