{"id":19195453,"url":"https://github.com/ardupilot/arduconfigurator","last_synced_at":"2026-03-03T19:03:28.644Z","repository":{"id":43120324,"uuid":"380618624","full_name":"ArduPilot/ArduConfigurator","owner":"ArduPilot","description":null,"archived":false,"fork":false,"pushed_at":"2022-04-09T15:23:37.000Z","size":102611,"stargazers_count":32,"open_issues_count":1,"forks_count":16,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-05-08T23:03:16.253Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArduPilot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-27T00:09:59.000Z","updated_at":"2025-04-07T11:17:52.000Z","dependencies_parsed_at":"2022-09-13T01:51:37.468Z","dependency_job_id":null,"html_url":"https://github.com/ArduPilot/ArduConfigurator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ArduPilot/ArduConfigurator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FArduConfigurator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FArduConfigurator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FArduConfigurator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FArduConfigurator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArduPilot","download_url":"https://codeload.github.com/ArduPilot/ArduConfigurator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FArduConfigurator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260271895,"owners_count":22984185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T12:10:04.836Z","updated_at":"2026-03-03T19:03:23.619Z","avatar_url":"https://github.com/ArduPilot.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ArduPilot Configurator\n\nArduPilot Configurator is a crossplatform configuration tool for the [ArduPilot](https://github.com/ArduPilot/ardupilot) flight control system.\n\nIt runs as an app within Google Chrome and allows you to configure the ArduPilot software running on any supported ArduPilot target.\n\nVarious types of aircraft are supported by the tool and by ArduPilot, e.g. quadcopters, hexacopters, octocopters and fixed-wing aircraft.\n\n![pic1](https://github.com/ArduPilot/ArduConfigurator/blob/master/configurator1.png?raw=true)\n![pic2](https://github.com/ArduPilot/ArduConfigurator/blob/master/configurator2.png?raw=true)\n![pic3](https://github.com/ArduPilot/ArduConfigurator/blob/master/configurator3.png?raw=true)\n![pic4](https://github.com/ArduPilot/ArduConfigurator/blob/master/configurator4.png?raw=true)\n![pic5](https://github.com/ArduPilot/ArduConfigurator/blob/master/configurator5.png?raw=true)\n![pic6](https://github.com/ArduPilot/ArduConfigurator/blob/master/configurator6.png?raw=true)\n\n\n## Installation\n\nDepending on target operating system, _ArduPilot Configurator_ is distributed as _standalone_ application or Chrome App.\n\n### Windows\n\n1. Visit [release page](https://github.com/ArduPilot/ArduConfigurator/releases)\n1. Download Configurator for Windows platform (win32 or win64 is present)\n1. Extract ZIP archive\n1. Run ArduPilot Configurator app from unpacked folder\n1. Configurator is not signed, so you have to allow Windows to run untrusted application. There might be a monit for it during first run \n\n### Linux\n\n1. Visit [release page](https://github.com/ArduPilot/ArduConfigurator/releases)\n1. Download Configurator for Linux platform (linux32 and linux64 are present)\n1. Extract tar.gz archive\n1. Make the ArduPilot-configurator file executable (chmod +x ArduPilot-configurator)\n1. Run ARDUPILOT Configurator app from unpacked folder\n\n### Mac\n\n1. Visit [release page](https://github.com/ArduPilot/ArduConfigurator/releases)\n1. Download Configurator for Mac platform\n1. Extract ZIP archive\n1. Run ArduPilot Configurator\n1. Configurator is not signed, so you have to allow Mac to run untrusted application. There might be a monit for it during first run \n\n### ChromeOS\n\n**ArduPilot Configurator** form ChromeOS is available in [Chrome Web Store](https://chrome.google.com/webstore/detail/ArduPilot-configurator/fmaidjmgkdkpafmbnmigkpdnpdhopgel)\n\n### Building and running ArduPilot Configurator locally (for development or Linux users)\n\nFor local development, **node.js** build system is used.\n\n1. Install pre-requisites:\n```\nsudo apt install curl git\n\n```\n\n2. Install 'nvm' , if you don't already have it, the 'node version manager', and use it to get node 16:\n```\nnvm --version\n\ncurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash\n\n. ~/.profile\n\ncommand -v nvm\n\nnvm install 16.14.0\n\nwhich node\n```\n\n3. download the app sources :\n```\ngit clone https://github.com/ArduPilot/ArduConfigurator.git\n\ncd ArduConfigurator\n\n```\n\n4. run the app in 'dev' mode [be sure your node is v16, see above at step 2 if its not]:\n```\nnode --version\n\nnpm install \n\nnpm run gulp build\n\nnpm run dev\n\n```\n\n\n### More info on some commands:\n\n - 'npm run dev' runs to it from the source folder without bundling any resources, great for debug and code hacking. Its also the only way the code runs right this instant., sorry, we haven't got any release ready yet. 'npm start' is very similar, but uses a 'bundled' main.html\n\n - 'npm start' is supposed to be the alternative to running it in dev mode, but as we dont have any release yet, its not the way we use the app at the moment, so this comment is a reminder to not use this command yet.\n\n - no right-click, no developer tools..? If the app starts-up for you, but right-click doesnn't allow you to use chrome-dev-tools or inspect stuff, then you don't have the 'sdk' version of NW installed.  Theese command/s to try to remedy that are (one or more of these might help), but are not part of a normal install, and you should not run them unless you somehow got the wrong 'nw' version:\n`nvm deactivate`\n`mv ~/.npmrc ~/.npmrc.bak`\n`rm -rf node_modules/nw`\n`rm package-lock.json`\n`npm install --save nw@0.50.3-sdk`\n`sudo npm install --save nw@0.50.3-sdk -g`\n`export NWJS_BUILD_TYPE=sdk; npm install`\n\n - Bundling/releasing not working properly just now, but when it's working it will run like this:\n'npm run gulp dist' to bundle it.\n'npm run gulp release' to make win32/win64/osx/linux32/linux64 packages.\n\n- this ap can be used as a chrome plugin, but usually is use \"integrated\" with nw.js [expect bugs if u do this] :  \n    - With NW.js: Run `npm start`[probably not working].\n    - With Chrome: Run `npm run gulp`. Then open `chrome://extensions`, enable\n    the `Developer mode`, click on the `Load unpacked extension...` button and select the `ArduConfigurator` directory.\n\n\n\n### Gulp hints? Other tasks are also defined in `gulpfile.js`. To run a task, use `npm run gulp task-name`. Available ones are:\n\n- **build**: Generate JS and CSS output files used by the configurator from their sources. It must be run whenever changes are made to any `.js` or `.css` files in order to have those changes appear\nin the configurator. If new files are added, they must be included in `gulpfile.js`. See the comments at the top of `gulpfile.js` to learn how to do so. See also the `watch` task.\n- **watch**: Watch JS and CSS sources for changes and run the `build` task whenever they're edited.\n- **dist**: Create a distribution of the app (valid for packaging both as a Chrome app or a NW.js app)\nin the `./dist/` directory.\n- **release**: Create NW.js apps for each supported platform (win32, osx64 and linux64) in the `./apps`\ndirectory. Running this task on macOS or Linux requires Wine, since it's needed to set the icon\nfor the Windows app. If you don't have Wine installed you can create a release by running the **release-only-linux** task.\n\n\n## BUGs?  absolutely.\n\nSee [BUGS page](https://github.com/ArduPilot/ArduConfigurator/blob/master/BUGS.md)\n\n\n## Different MAP providers? \n\nSee [MAPS page](https://github.com/ArduPilot/ArduConfigurator/blob/master/MAPS.md)\n\n\n## Notes\n\n### WebGL\n\nMake sure Settings -\u003e System -\u003e \"User hardware acceleration when available\" is checked to achieve the best performance\n\n### Linux users\n\n1. Dont forget to add your user into dialout group \"sudo usermod -aG dialout YOUR_USERNAME\" for serial access\n2. If you have 3D model animation problems, enable \"Override software rendering list\" in Chrome flags chrome://flags/#ignore-gpu-blacklist\n\n### WSL2\n\n1. The configurator will run on WSL2 as long as you have X configured and an X server running without auth (e.g. XLaunch)\n2. WSL2 does not support USB so no direct communication with flight controllers is currently possible\n\n## Support\n\nGitHub issue tracker is reserved for bugs and other technical problems. If you do not know how to setup\neverything, hardware is not working or have any other _support_ problem, please consult:\n\n* [discuss user forums thread](https://discuss.ardupilot.org/)\n\n* [developer chat](https://ardupilot.org/dev/docs/ardupilot-discord-server.html)\n\n## Issue trackers\n\nFor ArduPilot configurator issues raise them here\n\nhttps://github.com/ArduPilot/ArduConfigurator/issues\n\nFor ArduPilot firmware issues raise them here\n\nhttps://github.com/ArduPilot/ardupilot/issues\n\n## Developers\n\nWe accept clean and reasonable patches or PRs, submit them!\n\n## Credits - happy to correct these credits if they are wrong or incomplete.\n\nctn -  author and maintainer ofof stuff from which this project was forked.\nHydra - author and maintainer of stuff from which this project was forked.\nKonstantin Sharlaimov/DigitalEntity - author and maintainer of stuff from which this project was forked.\nPaweł Spychalski - author and maintainer of stuff from which this project was forked.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fardupilot%2Farduconfigurator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fardupilot%2Farduconfigurator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fardupilot%2Farduconfigurator/lists"}