Download

The current version is v0.9.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.

The app is signed and notarized by Apple, so it opens with a double-click.

Homebrew users can instead run:

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

Windows

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

The installer needs no administrator rights. It puts TonePush in the Start menu, with a desktop shortcut if you ask for one, and installs the tonepush command-line tool beside it. Remove it from Settings, Apps.

To run TonePush without installing, unpack an archive 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:

yay -S tonepush-bin     # ready made; tonepush builds the release from source, tonepush-git the latest commit

On Debian, Ubuntu and their derivatives, or on Fedora and other RPM distros, install the package for your machine, which also sets up the udev rule and desktop entry:

To run it without installing anything, use the AppImage. It needs glibc 2.39 or newer and still needs the udev rule below to reach the pedal:

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

Updating

TonePush asks GitHub once a day whether a newer version exists; nothing else is sent. When there is one, the foot of the sidebar says so in amber (for example 0.8.0 is out). Click it, or the settings button beside it, for the offer.

  • The Windows installer: click Update to 0.8.0. TonePush downloads the next installer, checks it against its release signature, runs it and opens the new version. The command-line tool updates with it.
  • The macOS app from the DMG, and the Windows and Linux archives: click Update to 0.8.0. TonePush downloads the new version, checks it against its release signature, and offers Restart to update. It closes, lets the pedal go and opens the new version; if that does not start, the previous one comes back. From an archive only the editor updates itself: keep tonepush-portable.txt next to tonepush-gui, and replace the tonepush command-line tool from a new archive when you want it newer too.
  • Homebrew, the AUR, .deb or .rpm: update through that package manager (brew upgrade, your AUR helper, apt or dnf). The settings say which.

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.