Installation

From a package manager

Several community members have taken care of setting up packages for their preferred operating systems and distributions. If you don’t see your system on this page, try checking repology to see whether one exists for your system.

Arch Linux

Using your preferred AUR helper, you can install iamb-git. For example, using paru:

paru iamb-git

FreeBSD

On FreeBSD a package is available from the official repositories. To install it simply run:

pkg install iamb

macOS

On macOS a package is available in Homebrew’s repository. To install it simply run:

brew install iamb

NetBSD / pkgsrc

On NetBSD (or any other system with pkgsrc available), you can install the iamb package:

pkgin install iamb

NixOS

There is an iamb package available in the 23.11 channel, or, if you have enabled flakes in Nix, you can install iamb from the Git repository via:

nix profile install "github:ulyssa/iamb/latest"

You can replace latest with a branch or specific version tag name if you want to install something besides the most recent release (e.g. main or v0.0.8).

openSUSE Tumbleweed

On openSUSE Tumbleweed a package is available from the official repositories. To install it simply run:

zypper install iamb

Snap

A snap is available for Linux distributions which support it:

snap install iamb

GitHub Releases

You can find .deb, .rpm and binaries built for x86_64 and aarch64 Linux from the Releases page on GitHub.

From crates.io

You can install the most recently published version of iamb from crates.io using cargo:

$ cargo install --locked iamb

This will install the iamb binary to ~/.cargo/bin/, which you should then place in your $PATH.

From Git Repository

If you are working on iamb or need a change that has not yet been published, you can clone the source from GitHub and build from that:

$ git clone https://github.com/ulyssa/iamb.git
$ cd iamb
$ cargo build --release
$ ./target/release/iamb --version
iamb 0.0.10 (2e6376f)

If you would like to build .deb or .rpm packages from the repository, you can do so using cargo-deb and cargo-generate-rpm respectively. For example:

$ cargo deb
   Compiling iamb v0.0.10 (/home/ufsm/src/iamb)
    Finished `release` profile [optimized] target(s) in 2m 25s
/home/ufsm/src/iamb/target/debian/iamb_0.0.10-1_amd64.deb

iamb documentation