Installation

Raffi needs nothing else to run. Pick whichever install method suits your system.

Package managers

Arch Linux

The AUR has a prebuilt package:

yay -S raffi-bin

paru -S raffi-bin works too. The raffi package builds from source instead.

Nix

From the unstable channel:

nix-shell -p raffi

Or add it to your NixOS configuration:

environment.systemPackages = with pkgs; [
  raffi
];

Homebrew

Homebrew and Linuxbrew both work:

brew tap chmouel/raffi https://github.com/chmouel/raffi
brew install raffi

Cargo

If you have a Rust toolchain:

cargo install raffi

Release archives

The releases page has archives and packages for each version. Extract the archive and put raffi somewhere in your PATH:

tar xzf raffi-*.tar.gz
sudo install -m 755 raffi /usr/local/bin/

If you only use Raffi through Fuzzel, see the Fuzzel page for a smaller build.

Building from source

git clone https://github.com/chmouel/raffi.git
cd raffi
cargo install --path .

cargo build --release works too if you’d rather copy target/release/raffi yourself.

Check that it works

raffi --help

prints every option. Run raffi on its own and you should see the applications installed on your system, ready to search.

Tip

Next, follow the quick start to write your first launchers and bind Raffi to a key.

Working on Raffi

To hack on Raffi, clone the repository and install the git hooks. They check formatting, lints and tests before you push:

pip install pre-commit
pre-commit install
cargo test