Skip to main content

Correctly configure ArduPilot for your vehicles on your first attempt

Lint Quality Test Security Deploy Maintain
Pylint Codacy Badge pytest status Known Vulnerabilities pages-build-deployment Average time to resolve an issue
test Python cleanliness OpenSSF Best Practices Pytest tests CodeQL Upload MethodicConfigurator Package Percentage of issues still open
mypy REUSE status Coverage Status gitavscan pypi python versions
Pyright md-link-check Coverity Scan Build Status OpenSSF Scorecard PyPI - Downloads Code Climate
markdown-lint pre-commit Discord Windows Build Update Flight Controller IDs

ArduPilot Methodic Configurator is a software, developed by ArduPilot developers, that semi-automates a clear, proven and safe configuration sequence for ArduCopter drones. We are working on extending it to ArduPlane, Heli and Rover vehicles. But for those it is still very incomplete.

  • clear: the sequence is linear, executed one step at the time with no hidden complex dependencies
  • proven: the software has been used by hundreds of ArduPilot developers and users. From beginners to advanced. On big and small vehicles.
  • safe: the sequence reduces trial-and-error and reduces the amount of flights required to configure the vehicle

Here are some YouTube video tutorials from the AMC YouTube Channel:

YouTube tutorial - intro YouTube tutorial - usecase

YouTube tutorial - beginners

And here is a presentation explaining it:

ArduPilot methodic configurator power point presentation

Comparison with Ground Control Station (GCS) software, traditionally used to configure ArduPilot before AMC existed:

Feature Mission Planner, QGroundControl, ... etc ArduPilot Methodic Configurator
full automatic configuration No No
configuration type manual 1 semi-automated 2
explains what to do No Yes
explains when to do something No Yes, explains the path
explains why do something No Yes
configuration method a different menu for each task, some tasks have no menu, so you need to dig into the 1200 parameters each task only presents you a relevant subset of parameters
parameter documentation Yes, only on the full-parameter tree view Yes
displays relevant documentation No Yes
makes sure you do not forget a step No Yes
checks that parameters get correctly uploaded No (MP), unsure (QGCS), yes (MAVProxy) Yes
reuse params in other vehicles No, unless you hand edit files Yes, out-of-the-box
documents why you changed each parameter No Yes
tutorials and learning resources No, scattered and not integrated Yes, context-aware help integrated
auto. install lua scripts on the FC No Yes
auto. backup of parameters before changing them No Yes

It's simple graphical user interface (GUI) manages and visualizes ArduPilot parameters, parameter files and documentation.

Application Screenshot

No visible menus, no hidden menus, no complicated options, what you see is what gets changed.

1. Quick overview of the entire process

To methodically build, configure and tune ArduPilot vehicles follow this sequence of steps:

1.1 Select the vehicle components

1.2 Install Software

1.3 Input vehicle components and component connections into ArduPilot Methodic Configurator

The software needs this information to automatically pre-select configuration settings relevant to your specific vehicle

1.4 Perform IMU temperature calibration before assembling the autopilot into the vehicle (optional)

IMU temperature calibration reduces the probability of Accel inconsistent and Gyro inconsistent errors and reduces the time required to arm the vehicle. IMU temperature calibration requires lowering the temperature of the autopilot (flight controller) to circa -20°C. That is harder to do once the autopilot is assembled inside the vehicle, hence it is done now.

1.5 Assemble all components except the propellers

Assemble and connect all components. Make sure you follow best practices

1.6 Basic mandatory configuration

Again using the ArduPilot Methodic configurator software GUI perform the following steps:

Now use Mission Planner to do:

And continue with the ArduPilot Methodic configurator software GUI :

1.7 Assemble propellers and perform the first flight

Now that all mandatory configuration steps are done you can perform the first flight

1.8 Minimalistic mandatory tuning

These are the very minimum tuning steps required for a stable flight:

That is it, if you are impatient and do not want an optimized vehicle you can skip to everyday use.

1.9 Standard tuning (optional)

These are the standard tuning steps required for an optimized flight:

Now the standard tuning is complete you can skip to everyday use

1.10 Improve altitude under windy conditions (optional)

1.11 System identification for analytical PID optimization (optional)

1.12 Position controller tuning (optional)

1.13 Everyday use

Now that tuning and configuration are done, some logging and tests can be disabled and some more safety features enabled:

Enjoy your properly configured vehicle.

The following sections describe each step of the procedure in more detail.

2. Install ArduPilot Methodic Configurator software on a PC or Mac

Install ArduPilot Methodic Configurator on MS windows, Linux or macOS

3. Install Mission Planner software on a PC or Mac

Install the latest Mission Planner version

4. Install ArduPilot firmware on the flight controller

Install the latest ArduPilot firmware on your flight controller board

5. Use the ArduPilot Methodic Configurator software for the first time

See the Use the ArduPilot Methodic Configurator software for the first time usecase.

6. Configure the vehicle's parameters in a traceable way

The following simple loop is presented as welcome instructions: AMC welcome instructions

Now do this in a loop until the software automatically closes or you are asked to close the software:

  • Read all the documentation links displayed at the top of the GUI (marked with the big red number 4),
  • Edit the parameter's New value and Reason changed fields to match your vehicle (marked with the big red number 5), documenting change reasons is crucial because it:
    • Promotes thoughtful decisions over impulsive changes
    • Provides documentation for vehicle certification requirements
    • Enables validation or suggestions from team members or AI tools
    • Preserves your reasoning for future reference or troubleshooting
  • Press Del and/or Add buttons to delete or add parameters respectively (marked with the big red number 5),
  • If necessary scroll down using the scroll bar on the right and make sure you edit all parameters,
  • Press Upload selected params to FC, and advance to next param file (marked with the big red number 7),
  • Repeat from the top until the program automatically closes.

7. Use the ArduPilot Methodic Configurator software after having created a vehicle from a template

See the Use the ArduPilot Methodic Configurator software after having created a vehicle from a template usecase.

Congratulations your flight controller is now fully configured in the safest and fastest way publicly known.

There is also documentation on other use cases and a detailed but generic Usermanual.

Install

See the install instructions

Documentation and Support

Need help or support

Contributing

Want to help us and contribute?

Software design and development

To meet the Software requirements a software architecture was designed and implemented.

Internationalization

The software is available in multiple languages. On MS Windows the language is selected during install and that selection is stored in the desktop icon. You can manually create multiple desktop icons, each will run the software in a different language. On Linux and macOS the language is selectable by the --language command line argument.

See contributing page if you want to help us translate the software into your language.

Code of conduct

To use and develop this software you must obey the ArduPilot Methodic Configurator Code of Conduct.

Compliance

ArduPilot Methodic Configurator adheres to multiple compliance standards and best practices:

Usability

  • Wizard like interface, allows user to concentrate in one task at a time
  • All GUI elements contain mouse over tooltips explaining their function
  • Relevant documentation opens automatically in a browser window
  • Uses What you see is what gets changed paradigm. No parameters are changed without the users's knowledge
  • Translated into multiple languages
  • No visible menus, no hidden menus.

Code Quality

Software Development

Open Source

Security

License

This software is cost free. This project is licensed under the GNU General Public License v3.0.

Credits

It builds upon other open-source software packages

<script async src="https://widget.gurubase.io/widget.latest.min.js" data-widget-id="uE4kxEE4LY3ZSyfNsF5bU6gIOnWGTBOL_e16KwDH-0g" data-text="Ask AI" data-margins='{"bottom": "1rem", "right": "1rem"}' data-light-mode="true" id="guru-widget-id"> </script>
  1. you need to know what/when/why you are doing ↩

  2. it explains what you should do, when you should do it and why ↩

Metadata

Release files for ardupilot-methodic-configurator 2.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ardupilot-methodic-configurator 2.1.1
File Size Uploaded Provenance Actions
ardupilot_methodic_configurator-2.1.1.tar.gz 6.0 MB With provenance Details for ardupilot_methodic_configurator-2.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ardupilot-methodic-configurator 2.1.1
File Interpreter ABI Platform Actions
ardupilot_methodic_configurator-2.1.1-py3-none-any.whl Python 3 none any Details for ardupilot_methodic_configurator-2.1.1-py3-none-any.whl

Total release size: 18.1 MB

Release files / ardupilot_methodic_configurator-2.1.1.tar.gz

Download URL ardupilot_methodic_configurator-2.1.1.tar.gz
Size 6.0 MB
Tags Source
SHA-256 checksum
How to use checksums
e0c7eeb904196dd2ce2af893cf5510f9491dd5c73a2df723aca41548949cb87b
BLAKE2b-256 checksum
How to use checksums
8cb8a3d5a6e06bd9a51995aa6361b6853127fb055abb8c637a7014800a01c625
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 5, 2025.

Transparency log

Release files / ardupilot_methodic_configurator-2.1.1-py3-none-any.whl

Download URL ardupilot_methodic_configurator-2.1.1-py3-none-any.whl
Size 12.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
bf958b207d212063198006ed2162eb84fc174cbb87808f34139d08170cde5a6c
BLAKE2b-256 checksum
How to use checksums
38687f0d4f8bb1ae1ec636c7b905162d33f427cfd1c21837e356f0129ab03cbe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 5, 2025.

Transparency log

Security for ardupilot-methodic-configurator 2.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ardupilot_methodic_configurator-2.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 5, 2025.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page