Skip to content

Hamr

A standalone search bar / launcher for Quickshell.

Features

  • Fast fuzzy search across apps, files, and plugins
  • Plugin system with JSON-over-stdio protocol
  • Frecency-based ranking (frequently used items rank higher)
  • Support for Hyprland and Niri compositors
  • Material Design 3 theming with dynamic color support

Quick Start

Installation

Install from AUR:

paru -S hamr

Enable and start the service:

systemctl --user enable --now hamr

Toggle the launcher with hamr toggle (bind this to a key in your compositor).

Basic Usage

Action Description
Start typing Search apps and indexed items
/plugin Open a specific plugin
Tab View actions for selected item
Enter Execute selected item/action
Escape Go back / close

Documentation

CLI Commands

hamr toggle              # Toggle launcher visibility
hamr plugin <name>       # Open specific plugin
hamr status              # Check if Hamr is running
hamr audio [sink|source] # Open audio controls