# Download




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

## macOS

One download for both Apple Silicon and Intel:

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

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

> **If macOS refuses to open the app**, it is because this build is not yet
> notarized with Apple. Right-click the app, choose Open, and confirm; macOS
> remembers the choice. This one-time step disappears once notarized builds
> ship.
{: .warning }

Homebrew users can instead run:

```sh
brew install --cask crmne/stompchain/stompchain-app   # the app
brew install crmne/stompchain/stompchain              # the CLI
```

## Windows

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

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

Unpack and run `stompchain-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 stompchain        # or: stompchain-git for the development build
```

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

- [stompchain-v0.1.2-x86_64-unknown-linux-gnu.tar.gz](https://github.com/crmne/stompchain/releases/download/v0.1.2/stompchain-v0.1.2-x86_64-unknown-linux-gnu.tar.gz)
- [stompchain-v0.1.2-aarch64-unknown-linux-gnu.tar.gz](https://github.com/crmne/stompchain/releases/download/v0.1.2/stompchain-v0.1.2-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.

## Build from source

Any platform, with [Rust](https://rustup.rs) installed:

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

Packagers should read
[PACKAGING.md](https://github.com/crmne/stompchain/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.