Audio processor preset gain normalization and measurement tools
Project description
MatchPatch
Watch the demo video · Read the documentation · Download MatchPatch
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
.hlsHelix setlists.hlxHelix presets- GUI-first workflows
Loopback and simulated modes are available for no-hardware tests. Hardware mode is for real Helix measurement.
Documentation
- Online manual: noseglasses.github.io/MatchPatch
- Start here: docs/index.md
- 10-minute guide: docs/quick-start.md
- Main manual: docs/musician-guide.md
- Test without hardware: docs/workflows/test-without-hardware.md
- Hardware measurement: docs/workflows/hardware-measurement.md
- Reference DI: docs/concepts/reference-di.md
- Troubleshooting: docs/troubleshooting.md
- FAQ: docs/faq.md
- Glossary: docs/glossary.md
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 the latest installer from
GitHub Releases,
run MatchPatch-Setup-<version>.exe, 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file matchpatch-0.8.2.tar.gz.
File metadata
- Download URL: matchpatch-0.8.2.tar.gz
- Upload date:
- Size: 2.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a54b4972c2b22256b5bc8bbda80f13c1cf8aea1967b7613f6a7aa5adbf66d88e
|
|
| MD5 |
51465262963d2824408e584eeb6026bc
|
|
| BLAKE2b-256 |
d92917dbc26e3f512b903f72a1e4606ca77031132f596537e8176a1c98c54738
|
File details
Details for the file matchpatch-0.8.2-py3-none-any.whl.
File metadata
- Download URL: matchpatch-0.8.2-py3-none-any.whl
- Upload date:
- Size: 116.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e2118a0d41a3e552eedd5d6354746b9aee810672b150dc2907ef38be1c03fe3
|
|
| MD5 |
d265e054dcc7f96f70b5c6443e5826b6
|
|
| BLAKE2b-256 |
f899a3ee8c1061decd8e86b74ebf643a5342a824ed26ebca2a8428815da1ff6e
|