Skip to content
chmouelPublic

About

A macOS Alfred alike application launcher for Wayland windows manager in Rust

Topics

Resources

Stars

122 stars

Watchers

1 watching

Forks

Repository files navigation

Raffi logo

Raffi

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.

Raffi with the preview pane open

The full documentation lives at https://chmouel.github.io/raffi/. More screenshots are further down.

Installation

Arch Linux (AUR):

yay -S raffi-bin

Nix:

nix-shell -p raffi

Homebrew or Linuxbrew:

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

With Cargo:

cargo install raffi

Prebuilt binaries are on the releases page. The installation guide covers building from source.

Bind it to a key

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.

Features

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.

Direct Answers:

Pick items

Desktop control:

Passwords access:

Chat:

Slack is off until you set it up. Then slack opens conversations, searches messages, lists what you haven't read and sets your status.

Look

You can change how Raffi looks with the built-in themes or your own colors.

Legacy Fuzzel support

If you already use Fuzzel, Raffi can show your apps and entries there instead. See the Fuzzel page for what that gives up.

Configuration

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 window

examples/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.

Contributing

Bug reports and pull requests are welcome on GitHub.

Screenshots

Search and Recent Picks

Main view with launchers and a recently picked demo snippet

One search listing a launcher and matching demo windows

Main view narrowed to Launchers with Ctrl+Tab

A demo installed app and its private-window desktop action

Desktop and Utilities

Window switcher with demo application and workspace details

Typed command ready to run in a terminal

Audio outputs with demo headphones selected

Typed output volume of 40 percent

Media playback controls and demo track details

Demo Bluetooth devices with connection and battery details

Session and power commands

Disposable demo worker's process details and signal actions

Calculator with expression preview and number bases

Currency converter with multi-currency preview

Unit conversion from kilometres per hour to miles per hour

Color conversion with swatches and CSS formats

Developer encoding and hashing tools

Time conversion between London and Tokyo

Clipboard and Passwords

Demo clipboard history with multiline text preview

Fictional password-store entries without decrypted secrets

Demo Bitwarden logins with public entry details

Files and Previews

File browser with directory preview

File browser source code preview

File browser image preview

File browser image preview scrolled to file details

File browser showing hidden files

Bundled file previewer highlighting demo Python source

File browser rendering a demo PDF page

File-only listing sorted by modification time

Search and Web

Text snippets with expanded content preview

Text snippet with expanded dynamic placeholders and raw template

Emoji picker with Unicode and glyph preview

Web search with resolved URL preview

Browser tabs with site icons and a page preview

Browser tabs setup steps when no browser is connected

Bookmarks toolbar folder with a bookmark's details in the preview

Browser history rows with site, profile and visit time

Configured fallback search results and preview

Search, Help, and Scripts

Keyword suggestion while typing

Keyword and shortcut help list

Keyboard shortcut help filtered to the preview shortcuts

Inline launcher script shown in the preview pane

Timezone script filter with ANSI-formatted preview

Pull request script filter with CI status and details

Herdr demo workspace, session and pane tree

Herdr demo agents grouped by status with terminal preview

Themes

Built-in light theme

Catppuccin Mocha theme

Nord theme

Gruvbox Dark theme

Solarized Light theme

Tokyo Night theme

Licence

This project is released under the MIT Licence.

Author

Sponsor

Chmouel Boudjnah

About

A macOS Alfred alike application launcher for Wayland windows manager in Rust

Topics

Resources

Stars

122 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages