Config File Diff Viewer
If your aircraft has two or more configuration files uploaded, you can compare them side-by-side to see exactly what settings changed between versions. This is especially useful for tracking PID adjustments, filter tuning, or other parameter changes.
How to open the diff viewer
Step 1: Check the prerequisite
The diff viewer is only available if your UAV has at least 2 config files. If you have fewer than 2, upload another config first (see Configuration Files).
Step 2: Select two files
A blue info bar appears at the top of the Configuration Files section showing "Select 2 files to compare (0/2)". Each config file in the list below now has a checkbox to its left. Check the boxes next to the two files you want to compare. Once you've selected 2 files:
- The counter updates: "Select 2 files to compare (2/2)"
- All other checkboxes become disabled (grayed out) to prevent further selections
- A blue Compare button appears on the right side of the info bar
Step 3: Open the modal
Click the Compare button. A full-screen modal opens with the diff viewer displaying both files side-by-side.
Understanding the diff viewer
Layout
- Left pane — First selected file (header shows filename)
- Right pane — Second selected file (header shows filename)
- Both panes are scrollable independently; scroll to compare different sections
Color coding
- Red background — Line removed (present in left file only). Marked with a
−in the gutter. - Green background — Line added (present in right file only). Marked with a
+in the gutter. - Gray/neutral background — Unchanged line. Shows the line number in the gutter.
Special cases
- Files are identical: If the two files have no differences, a centered message displays: "Files are identical". You may have selected the same file twice or files with matching content.
- Error loading: If there's an error retrieving the files (e.g., network issue), an error message appears. Check your connection and try again.
- Loading state: A spinner appears while the diff is being computed.
Navigation and closing
- Click the × button (top-right) to close the viewer.
- Closing the viewer automatically clears your file selection (the checkboxes return to unchecked, and the counter resets to "0/2").
Examples and use cases
Scenario 1: PID tuning
You have "PID_conservative" and "PID_race" configs. Upload both, then compare them to see which parameters differ between the conservative and aggressive tunes. This helps you understand the effects of each change.
Scenario 2: Before/after filter adjustment
Before adjusting gyro or D-term filters, save your current config as "baseline". After tuning, upload the new config and compare it to the baseline. The diff shows exactly which filter values you modified.
Scenario 3: Tracking firmware updates
If your flight controller firmware was updated and you re-exported your config, compare the old and new versions to see if any parameters were reset or changed by the firmware upgrade.
Always save the "before" version of your config before making large changes. This way you can later compare what you changed and understand the impact of your tuning adjustments.
Next: Learn about Maintenance Logs.