Skip to content

noseglasses/MatchPatch

Repository files navigation

MatchPatch

MatchPatch: Normalize presets. Match volume.

Quality Release PyPI Python

No more unexpected volume jumps when switching sounds.

MatchPatch automatically equalizes the loudness of presets and snapshots in guitar processors such as the Line 6 Helix.

Why MatchPatch?

You create a great clean sound. You create a great lead sound. Then you switch between them and one is much louder than the other.

MatchPatch measures your presets and calculates the gain adjustments needed to make them consistent, so your setlist feels balanced before rehearsal or stage use.

Features

  • Measure preset loudness automatically.
  • Analyze snapshots.
  • Calculate required gain corrections.
  • Modify Helix setlists and presets.
  • Test the workflow without hardware.
  • Configure normal runs from the GUI.
  • Use CLI and worker commands for advanced scripting.
  • Open source.

Current Support

Current normal workflows support:

  • Line 6 Helix
  • .hls Helix setlists
  • .hlx Helix presets
  • GUI-first workflows

Loopback and simulated modes are available for no-hardware tests. Hardware mode is for real Helix measurement.

Documentation

Safety Notes

Warning: Keep backups of your original Helix files.

Warning: Measurement files are for measuring, not for live playing.

Install And Launch

On Windows, download MatchPatch-Setup-<version>.exe from GitHub Releases, run the installer, then launch MatchPatch from the Start Menu. The installed app bundles offline Help, available from the GUI.

For source checkouts, use the verified local setup commands below and see Developer Notes and developer commands for fuller setup details.

Install the optional GUI support and launch MatchPatch:

# Linux or WSL
scripts/sync-wsl.sh --extra gui
matchpatch-gui
# Windows PowerShell
cd C:\src\MatchPatch-windows
.\scripts\sync-windows.cmd --extra gui
.\.venv-windows\Scripts\matchpatch-gui.exe

Hardware measurement from WSL needs a synced native Windows runtime. See developer commands before using real Helix hardware from WSL.

Advanced And Developer Information

Technical details live in the developer docs:

License

MatchPatch is open source software released under the MIT License.