Skip to main content

Audio processor preset gain normalization and measurement tools

Reason this release was yanked:

Dependency issues

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.1.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.1-py3-none-any.whl (116.0 kB view details)

Uploaded Python 3

File details

Details for the file matchpatch-0.8.1.tar.gz.

File metadata

  • Download URL: matchpatch-0.8.1.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.1.tar.gz
Algorithm Hash digest
SHA256 b064d66ade7c680f6e773ba6aa1d1c9002b68896b78d9fb38e38cd73183111d3
MD5 f361c513a6734261698827b8c18c297a
BLAKE2b-256 04ad1bb121ea20066a7e5ab3cc51b7d80e7f7c7d675fd3405970798c08f99667

See more details on using hashes here.

File details

Details for the file matchpatch-0.8.1-py3-none-any.whl.

File metadata

  • Download URL: matchpatch-0.8.1-py3-none-any.whl
  • Upload date:
  • Size: 116.0 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e935ff3ddcd4eae82b8f42de9966d413eeea87e1773efc8958d62994ad457262
MD5 9c28b7fa37287f777f5b0d01ba1374b9
BLAKE2b-256 c99fd844b435b93b861f5f4dfb6c8fa2a46a03b64aff89e4e9618c2b38c800c9

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