fuzzel

Launch applications using a fuzzy finder

TLDR

Run applications

$ fuzzel

Run fuzzel in dmenu mode

$ fuzzel [[-d|--dmenu]]

Display a menu of the output of the ls command

$ [ls] | fuzzel [[-d|--dmenu]]

Display a menu with custom items separated by a new line (\n)

$ echo -e "[red]\n[green]\n[blue]" | fuzzel [[-d|--dmenu]]

Let the user choose between multiple items and save the selected one to a file

$ echo -e "[red]\n[green]\n[blue]" | fuzzel [[-d|--dmenu]] > [color.txt]

Reset apps usage count (default cache directory: $XDG_CACHE_HOME/fuzzel)

$ rm [[-v|--verbose]] $HOME/.cache/fuzzel

Launch fuzzel on a specific monitor, see wlr-randr or swaymsg --type get_outputs

$ fuzzel [[-o|--output]] "[DP-1]"

Use fuzzel to do an online search

$ fuzzel [[-d|--dmenu]] [[-l|--lines]] 0 --placeholder "[Type your search]" | sed 's/^/\"/g;s/$/\"/g' | xargs firefox --search

-h, --help
    Show help message and exit.

-v, --version
    Show version information and exit.

-c, --config
    Specify a configuration file.

-i, --insensitive
    Make the search case-insensitive.

-w, --window-title
    Set the window title.

-d, --direction
    Set the direction of the fuzzel window (up, down, left, right).

-t, --terminal
    Specify terminal command to use to launch.

DESCRIPTION

Fuzzel is a minimalist application launcher specifically designed for Wayland compositors. It offers a fast and efficient way to launch applications, switch between windows, and perform other actions. It relies on a fuzzy matching algorithm to quickly find entries based on partial or misspelled inputs. Its design prioritizes speed, simplicity, and a clean user interface. Configuration is typically done via a configuration file, allowing for customization of appearance, keybindings, and available actions. Fuzzel aims to be a lightweight and flexible alternative to more complex application launchers like rofi or dmenu.

CAVEATS

Fuzzel is primarily designed for Wayland compositors and may not function correctly on other display servers. Its configuration is often file-based, requiring users to manually edit a configuration file to customize its behavior.

CONFIGURATION

The primary way to configure fuzzel is through its configuration file. The location of the config file will depend on your system, and is likely to be in $HOME/.config/fuzzel/config.ini.
Within this file, keybindings, fonts, colors and custom commands can be configured.

USAGE EXAMPLES

Launching fuzzel with a specific configuration file: fuzzel -c ~/.config/fuzzel/my_config.ini
Launching fuzzel with case-insensitive search: fuzzel -i
Setting a specific title: fuzzel -w "Application Launcher"

HISTORY

Fuzzel emerged as a lightweight alternative to existing application launchers, catering to users seeking a minimal and efficient solution for Wayland environments. It was developed with a focus on performance and a clean user interface.