Beta

garlaunch

Application Launcher

A rofi-like application launcher with fuzzy search and multiple modes. Launch applications, run commands, switch windows, or interact with custom scripts.

View on GitHub Install
garlaunch screenshot 1200 × 700

Features

  • Fuzzy search powered by nucleo
  • Desktop entry mode (drun) for .desktop files
  • Command execution mode (run) for PATH binaries
  • Window switcher mode
  • Custom script mode with JSON protocol
  • Daemon mode with IPC control
  • Keyboard-driven interface
  • Built on gartk for consistent UI

Installation

bash
$ curl -fsSL https://gar.dev/install.sh | bash -s -- --component=garlaunch

Or use the universal installer to install all components.

Configuration

config.toml 
# ~/.config/garlaunch/config.toml (planned)

[general]
# Default mode
default_mode = "drun"

# Maximum visible items
max_items = 10

[theme]
# Use gartk theme
theme = "dark"

# Override specific colors
background = "#1e1e2e"
foreground = "#cdd6f4"
selection = "#45475a"

[modes.drun]
# Directories to scan for .desktop files
dirs = [
  "/usr/share/applications",
  "~/.local/share/applications"
]

[modes.script]
# Default script timeout (seconds)
timeout = 30

Usage

$ garlaunch # Launch in drun mode (default)
$ garlaunch --mode run # Run command mode
$ garlaunch --mode window # Window switcher
$ garlaunch --mode script --source ./myscript.sh # Custom script
$ garlaunch --daemon # Run as daemon for IPC control

Bind garlaunch to a key in your gar configuration:

gar.key({ gar.mod, "d", gar.spawn("garlaunch") })

Modes

drun

Scans XDG application directories for .desktop files. Shows application name, description, and icon.

run

Lists executables from $PATH. Type to filter and press Enter to run.

window

Shows open windows from EWMH-compliant window managers. Select to focus.

script

Executes a script that outputs JSON items. Allows custom menus and actions.

Control with garlaunchctl

$ garlaunchctl show # Show launcher (drun mode)
$ garlaunchctl show --mode window # Show window switcher
$ garlaunchctl toggle # Toggle visibility
$ garlaunchctl status # Check daemon status

If the daemon isn't running, garlaunchctl will spawn garlaunch directly.

Keyboard Shortcuts

  • Enter Activate selected item
  • Escape Close launcher
  • Up / Down Navigate items
  • Page Up / Down Navigate by page
  • Home / End Move cursor in input
Back to home