Skip to main content

Audio processor preset gain normalization and measurement tools

Project description

MatchPatch

MatchPatch: Normalize presets. Match volume.

Quality Release PyPI Python

Watch the demo video · Read the documentation · Download MatchPatch

MatchPatch GUI showing a loaded Helix setlist

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 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

matchpatch-0.8.2.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

matchpatch-0.8.2-py3-none-any.whl (116.3 kB view details)

Uploaded Python 3

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

Hashes for matchpatch-0.8.2.tar.gz
Algorithm Hash digest
SHA256 a54b4972c2b22256b5bc8bbda80f13c1cf8aea1967b7613f6a7aa5adbf66d88e
MD5 51465262963d2824408e584eeb6026bc
BLAKE2b-256 d92917dbc26e3f512b903f72a1e4606ca77031132f596537e8176a1c98c54738

See more details on using hashes here.

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

Hashes for matchpatch-0.8.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4e2118a0d41a3e552eedd5d6354746b9aee810672b150dc2907ef38be1c03fe3
MD5 d265e054dcc7f96f70b5c6443e5826b6
BLAKE2b-256 f899a3ee8c1061decd8e86b74ebf643a5342a824ed26ebca2a8428815da1ff6e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page