# Download




The current version is **v0.3.0**. Every file below, with its SHA-256, is
listed in [checksums.txt](https://github.com/crmne/tonepush/releases/download/v0.3.0/checksums.txt); older versions live on
the [releases page](https://github.com/crmne/tonepush/releases).

## macOS

One download for both Apple Silicon and Intel:

- [tonepush-v0.3.0-macos-universal.dmg](https://github.com/crmne/tonepush/releases/download/v0.3.0/tonepush-v0.3.0-macos-universal.dmg)

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:

```sh
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):

- [tonepush-v0.3.0-x86_64-pc-windows-msvc.zip](https://github.com/crmne/tonepush/releases/download/v0.3.0/tonepush-v0.3.0-x86_64-pc-windows-msvc.zip)
- [tonepush-v0.3.0-aarch64-pc-windows-msvc.zip](https://github.com/crmne/tonepush/releases/download/v0.3.0/tonepush-v0.3.0-aarch64-pc-windows-msvc.zip)

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:

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

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

- [tonepush-v0.3.0-x86_64-unknown-linux-gnu.tar.gz](https://github.com/crmne/tonepush/releases/download/v0.3.0/tonepush-v0.3.0-x86_64-unknown-linux-gnu.tar.gz)
- [tonepush-v0.3.0-aarch64-unknown-linux-gnu.tar.gz](https://github.com/crmne/tonepush/releases/download/v0.3.0/tonepush-v0.3.0-aarch64-unknown-linux-gnu.tar.gz)

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

```sh
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](https://rustup.rs) installed:

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

Packagers should read
[PACKAGING.md](https://github.com/crmne/tonepush/blob/main/PACKAGING.md),
which covers offline builds from the vendored-dependencies archive.

## After installing

Whichever route you took, finish with [Getting Started](/getting-started/):
one extraction step gives you model names and artwork, and there are a few
things worth knowing before your first edit.