LinuxCommandLibrary

fuzzel

Wayland application launcher with fuzzy search

TLDR

Run applications

$ fuzzel
copy
Run fuzzel in dmenu mode
$ fuzzel -d
copy
Display a menu of the output of a command
$ ls | fuzzel -d
copy
Display a menu with custom items separated by newline
$ echo -e "red\ngreen\nblue" | fuzzel -d
copy
Let the user choose between items and save the selected one
$ echo -e "red\ngreen\nblue" | fuzzel -d > color.txt
copy
Reset apps usage count
$ rm -v $HOME/.cache/fuzzel
copy
Launch fuzzel on a specific monitor
$ fuzzel -o "DP-1"
copy
Use fuzzel for online search
$ fuzzel -d -l 0 --placeholder "Type your search" | xargs firefox --search
copy

SYNOPSIS

fuzzel [options]

DESCRIPTION

fuzzel is a Wayland-native application launcher with fuzzy matching, inspired by rofi and dmenu. It scans XDG application directories and presents a searchable list of installed applications.
In dmenu mode (-d), fuzzel reads items from stdin and outputs the selected item to stdout, making it useful for scripting and building interactive menus. The fuzzy matching algorithm prioritizes matches at word boundaries and beginning of strings.
Configuration is stored in ~/.config/fuzzel/fuzzel.ini with extensive customization for appearance, behavior, and keybindings.

PARAMETERS

-d, --dmenu

Run in dmenu mode, reading items from stdin
-o, --output OUTPUT
Show on specified Wayland output (monitor)
-l, --lines N
Maximum number of lines to show (0 for single line)
-w, --width N
Window width in characters
-f, --font FONT
Font specification
-b, --background COLOR
Background color in RRGGBBAA format
-t, --text-color COLOR
Text color in RRGGBBAA format
-p, --prompt TEXT
Set prompt text
--placeholder TEXT
Placeholder text when input is empty
-i, --icon-theme THEME
Icon theme name
-T, --terminal CMD
Terminal command for launching terminal apps

CONFIGURATION

~/.config/fuzzel/fuzzel.ini

Appearance, behavior, keybindings, and default options.
~/.cache/fuzzel
Usage frequency tracking for application sorting.

CAVEATS

Wayland-only; does not work on X11. Application icons require an icon theme installed. Cache file in ~/.cache/fuzzel tracks usage frequency for sorting; delete to reset.

HISTORY

fuzzel was created by Daniel Eklof (the same developer as foot terminal) and first released around 2020. It was designed specifically for Wayland compositors as a lightweight alternative to rofi, which primarily targets X11.

SEE ALSO

rofi(1), dmenu(1), wofi(1), bemenu(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community