INAV Configurator is a cross-platform configuration tool for the INAV flight control system.
It runs as an app within Google Chrome and allows you to configure the INAV software running on any supported INAV target.
Various types of aircraft are supported by the tool and by INAV, e.g. quadcopters, hexacopters, octocopters, and fixed-wing aircraft.
INAV Configurator comes as is
, without any warranty and support from the authors. If you find a bug, please create an issue on GitHub.
The GitHub issue tracker is reserved for bugs and other technical problems. If you do not know how to set up everything, the hardware is not working, or you have any other support problem, please consult:
INAV Configurator is distributed as a standalone application.
Visit release page
Download Configurator for Windows platform (ia32 or win64 is present)
Install
INAV-Configurator_win32_arch_x.y.z.msi
, arch is your computer architecture (ia32 (32bit) or x64 (64bit)), x.y.z is the INAV Configurator version number.Configurator is not signed, so you have to allow Windows to run untrusted applications. There might be a monit for it during the first run
Visit release page
Download Configurator for Linux platform (only linux64 is present)
sudo dnf localinstall /path/to/INAV-Configurator_linux_x64-x.y.z.rpm
or open it with a package manager (e.g. via Files)sudo apt install /path/to/INAV-Configurator_linux_x64_x.y.z.deb
or open it with a package manager (e.g. via the File Manager)Change to the directory containing the downloaded zip file
download this file to the same directory. Its filename should be inav-configurator.desktop
.
Extract zip archive
unzip INAV-Configurator_linux_arch_x.y.z.zip -d /tmp/
arch is your computer architecture (x64, armv7l, ...), x.y.z is the INAV Configurator version number.
If this is the first time installing INAV Configurator, create a home for its files
sudo mkdir /opt/inav
sudo chown $USER /opt/inav
Move the temporary files into their home
mv /tmp/INAV\ Configurator /opt/inav/inav-configurator
Update the application icon.
sudo mkdir /opt/inav/inav-configurator/icon
sudo cp /opt/inav/inav-configurator/images/inav_icon_128.png /opt/inav/inav-configurator/icon
As a one-off, move the desktop file into the applications directory
sudo mv inav-configurator.desktop /usr/share/applications/
Make the following files executable:
chmod +x /opt/inav/inav-configurator/inav-configurator
Run the INAV Configurator app from the unpacked folder /opt/inav/inav-configurator/inav-configurator
For local development, the node.js build system is used.
npm install
npm start
.To build the App run npm run make
to build for your platform.
Options:
See Electron Forge CLI Documentation for details
Note: Not all architectures are available for all platforms. For example, ia32 (32bit) support is not available for Linux. Tested architectures:
To build the setup program for windows, you have to install WiX Toolset V3 and add the bin
folder to you PATH
, e.g.
C:\Program Files (x86)\WiX Toolset v3.14\bin
To build deb and rpm packages for Linux, you have to install the following packages:
dpkg, fakeroot, rpm, build-essential, libudev-dev
dpkg, fakeroot, rpmbuild, systemd-devel, devel-basis (zypper install -t pattern devel_basis), zip
Example (note the double -- ):
npm run make -- --arch="x64"
To be able to open Inspector, set environment variable NODE_ENV
to development
or set the flag directly when run npm start
:
NODE_ENV=development npm start
or $env:NODE_ENV="development" | npm start
for Windows PowerShell
Or use vscode and start a debug session Debug Configurator
(Just hit F5!)
INAV Configurator 2.1 allows you to choose between OpenStreetMap, Bing Maps (Aerial View), and MapProxy map providers. INAV Configurator is shipped WITHOUT API key for Bing Maps. That means: every user who wants to use Bing Maps has to create their own account, agree to all Terms and Conditions required by Bing Maps, and configure INAV Configurator by himself.
INAV provides the font images so that custom fonts can be created for your personal preference. This is the case for both analogue and digital fonts. The resources can be found in the osd folder. Within the analogue and digital subfolders, you will find information on compiling your own fonts. There is also an INAV Character Map document. This contains previews of all the character images in the fonts and the appropriate variable names within the firmware and Configurator. There are tools for compiling the analogue and digital fonts. New font submissions via pull requests are welcome.
Make sure Settings -> System -> "User hardware acceleration when available" is checked to achieve the best performance
For INAV configurator issues raise them here
https://github.com/iNavFlight/inav-configurator/issues
For INAV firmware issues, raise them here
https://github.com/iNavFlight/inav/issues
We accept clean and reasonable patches, submit them!