Raffi is a keyboard-driven search box for your Wayland desktop. From one place you can open apps, browse files, switch windows, paste from your clipboard history, fill in passwords, do sums, convert currencies and a lot more. It is written in Rust, starts fast, and needs a daemon and database only for its built-in clipboard history.
It works as soon as it is installed. A YAML file lets you pick a theme, choose which addons are on, add web searches and snippets, and add commands or scripts of your own.
The full documentation lives at https://chmouel.github.io/raffi/. More screenshots are further down.
Arch Linux (AUR):
yay -S raffi-binNix:
nix-shell -p raffiHomebrew or Linuxbrew:
brew tap chmouel/raffi https://github.com/chmouel/raffi
brew install raffiWith Cargo:
cargo install raffiPrebuilt binaries are on the releases page. The installation guide covers building from source.
Run raffi and start typing. With no config yet, Raffi searches your installed applications, open windows and system commands in one list, so you can try it straight away.
Most people bind it to a key in their compositor. For Sway:
bindsym Mod4+Space exec raffi
For Hyprland's Lua config:
hl.bind("SUPER + R", hl.dsp.exec_cmd("raffi"))For niri:
binds {
Mod+R { spawn "raffi"; }
}Inside Hyprland, niri and Sway, Raffi asks the compositor to start the app you pick. The Sway, Hyprland and niri pages cover window rules and more examples, and the CLI reference lists every flag.
Type to search, use the arrow keys to move, and press Enter. A preview pane on the right shows what the selected entry will do, and Ctrl+P hides or shows it. Press Ctrl+/, or type ? on its own, to see every keyword and shortcut your config turns on. If you forget a keyword, type what you want, such as volume or password, and Raffi suggests the right one.
Some lists have more than one view, and Ctrl+Tab always switches between them, with Ctrl+Shift+Tab going back. The footer tells you which view you are on. See keyboard shortcuts for the full list.
Most addons start with a keyword followed by a space. Others answer as soon as your search looks like something they understand.
- Calculator: type a sum like
2*(3+4) - Currency converter:
$10 to eur - Unit conversion:
10 km to mi,70f to c - Color converter:
#ff8800orrgb(255 136 0) - World clock:
time tokyo,15:00 paris to nyc - Developer tools:
devto encode, decode or hash text, plus UUID and password generators
- File browser: start with
/or~/, with previews of PDFs, images, videos and source code - Emoji and Nerd Font icons:
emoji - Clipboard history from CopyQ or Raffi itself:
clip, orraffi clipboardfrom a script - Text snippets, web searches and script filters, each under a keyword you choose
- Installed apps, with their actions such as opening a private window
- System commands to lock, suspend, log out or shut down:
sys - Window switcher for Hyprland, niri and sway:
win - Browser tabs through the Vicinae browser extension:
tabs - Bookmarks: search and open browser bookmarks:
bm - Browser history: search visited pages browser by browser:
hist - Media controls:
media - Audio devices and volume:
audio - Bluetooth:
bt - Stop a process:
kill - Run a command in a terminal:
> htop
Slack is off until you set it up. Then slack opens conversations, searches messages, lists what you haven't read and sets your status.
You can change how Raffi looks with the built-in themes or your own colors.
If you already use Fuzzel, Raffi can show your apps and entries there instead. See the Fuzzel page for what that gives up.
Raffi needs no config to start. When you want to change something, settings go in ~/.config/raffi/raffi.yaml:
general:
theme: dark
main_view: [launchers, windows, browser_tabs, system, clipboard]
addons:
apps:
enabled: true
web_searches:
- name: Google
keyword: g
url: "https://google.com/search?q={query}"main_view picks what shows up in the main list as you type. Omitting it keeps the default sources even after you add a config file; null or [] shows only apps and your own entries. apps keeps installed applications listed after you add entries of your own, and web_searches turns g rust into a Google search.
Commands and scripts of your own go in ~/.config/raffi/launchers.yaml:
firefox_private:
binary: firefox
args: [--private-window]
icon: firefox
description: Firefox private windowexamples/raffi.yaml shows every setting with a comment, and examples/launchers.yaml has entries to copy from. The configuration guide covers settings, addons and custom entries.
Bug reports and pull requests are welcome on GitHub.
This project is released under the MIT Licence.
- Fediverse - @chmouel@chmouel.com
- Twitter - @chmouel
- Blog - https://blog.chmouel.com