Download

The current version is v0.3.0. Every file below, with its SHA-256, is listed in checksums.txt; older versions live on the releases page.

macOS

One download for both Apple Silicon and Intel:

Open it and drag TonePush to Applications. The DMG also carries the tonepush command-line tool; copy it somewhere on your PATH if you want it.

First open on macOS

This build is not yet notarized with Apple, so macOS blocks it the first time. Recent macOS versions (Sequoia and later) no longer let you bypass this with a right-click, so you open it once through Privacy & Security instead:

  1. Double-click TonePush in Applications. macOS says it cannot be opened because Apple cannot check it for malicious software. Click Done (do not click Move to Trash).
  2. Open System Settings, then Privacy & Security.
  3. Scroll down to the Security section. You will see a line like “TonePush was blocked to protect your Mac” with an Open Anyway button next to it. Click it.
  4. Authenticate with Touch ID or your password, then click Open Anyway once more in the confirmation dialog.

The app opens, and macOS remembers the choice: every launch after this is an ordinary double-click. This whole step disappears once notarized builds ship.

Homebrew users can instead run:

brew install --cask crmne/tap/tonepush-app   # the app
brew install crmne/tap/tonepush              # the CLI

Windows

Almost every PC wants the first one; the second is for Windows on ARM (Surface and other Snapdragon machines):

Unpack and run tonepush-gui.exe. SmartScreen may warn about an unknown publisher on first run; choose More info, then Run anyway.

Linux

On Arch and its derivatives, install from the AUR, which also sets up the udev rule and desktop entry:

paru -S tonepush        # or: tonepush-git for the development build

On any other distro, grab the archive for your machine:

Unpack it, put the two binaries on your PATH, and install the packaged udev rule so you can open the device without root:

sudo install -m644 packaging/udev/70-line6-hx.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

Then replug the pedal once. For the first-launch extraction of HX Edit’s model data, install p7zip too; the AUR package already suggests it.

Build from source

Any platform, with Rust installed:

git clone https://github.com/crmne/tonepush
cd tonepush
./install.sh

Packagers should read PACKAGING.md, which covers offline builds from the vendored-dependencies archive.

After installing

Whichever route you took, finish with Getting Started: one extraction step gives you model names and artwork, and there are a few things worth knowing before your first edit.