Download

The current version is v0.12.1. 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 and installs the tonepush command-line tool beside it. A copy installed with an earlier TonePush setup program (-setup.exe, 0.9.0 to 0.10.0) is updated in place, keeping its folder, its desktop shortcut and your settings. 0.9.1 and later move to the installer by themselves; from 0.9.0, run the installer once by hand, as that version no longer finds updates. Remove TonePush from Settings, Apps. Installing or removing it waits until TonePush and any tonepush command have quit: quit them and try again.

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 Fedora, install from the COPR repository, so dnf updates TonePush with the rest of your system. It also sets up the udev rule and desktop entry:

sudo dnf copr enable paolino/tonepush
sudo dnf install tonepush

On Debian, Ubuntu and their derivatives, or on openSUSE and other RPM distros, or to install one release by hand, 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. It mentions a new version only once that version’s signature checks out. The foot of the sidebar then says so in amber (for example 0.12.0 is out). Click it, or the settings button beside it, for the details.

  • The macOS app from the DMG, the Windows installer, the AppImage, and the Windows and Linux archives: TonePush updates itself. A new version on the same major release downloads in the background, is checked against its release signature, and installs the next time TonePush starts, before the window opens. If the new version does not start, the previous one comes back. To update straight away, click Restart to update: TonePush closes, lets the pedal go and opens the new version. A new major version (1.0 after 0.x) waits until you click Update to. To be asked about every version, set Install updates automatically to Off in the settings. 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, the COPR, .deb, .rpm or the Flatpak: update through that package manager. The settings show the command that updates your copy, such as yay -Syu tonepush-bin, with a Copy button. TonePush never runs it for you.

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.