launch-bar

Crates.iolaunch-bar
lib.rslaunch-bar
version0.1.0
created_at2026-01-25 15:23:09.518435+00
updated_at2026-01-25 15:23:09.518435+00
descriptionContext-aware command launcher with icon buttons
homepage
repositoryhttps://github.com/ynishi/launch-bar
max_upload_size
id2068937
size159,004
Yutaka Nishimura (ynishi)

documentation

README

launch-bar

Context-aware command launcher with icon buttons for developers.

Crates.io License GitHub

Features

  • Auto-detection: Detects project type by file presence (Cargo.toml, package.json, etc.)
  • Preset system: Configurable command sets per project type with custom colors
  • Visual feedback: Process status indicators (running/success/failed)
  • File watcher: Highlights when files in the working directory change
  • Position memory: Remembers window position per directory
  • Clipboard support: Use $clipboard variable in commands
  • Transparent UI: Semi-transparent window with customizable opacity

Installation

cargo install launch-bar

Usage

# Run in current directory (auto-detects project type)
launch-bar

# Use specific preset
launch-bar --preset RustDev

# Create local config in current directory
launch-bar --init

# Create/reset global config
launch-bar --init-global

Configuration

Configuration files are loaded in this order:

  1. ./launch-bar.toml (local, highest priority)
  2. ~/.config/launch-bar/config.toml (global)

Example config

[window]
max_icons = 5              # Maximum icons to display
opacity = 0.8              # Background opacity (0.0 - 1.0)
border = "auto"            # "auto", "show", "hide"
title_bar = "auto"         # "auto" (hover), "show", "hide"
accent_line = "auto"       # "auto" (highlight on change/hover), "show", "hide"

[[presets]]
name = "RustDev"
detect_file = "Cargo.toml"
base_color = "#FF7043"
commands = [
    { name = "Run", cmd = "cargo run", icon = "play" },
    { name = "Test", cmd = "cargo test", icon = "check" },
    { name = "Build", cmd = "cargo build --release", icon = "wrench" },
    { name = "Clean", cmd = "cargo clean", icon = "broom" },
    { name = "Fmt", cmd = "cargo fmt", icon = "edit" },
]

[[presets]]
name = "NodeDev"
detect_file = "package.json"
base_color = "#66BB6A"
commands = [
    { name = "Start", cmd = "npm start", icon = "play" },
    { name = "Test", cmd = "npm test", icon = "check" },
    { name = "Build", cmd = "npm run build", icon = "wrench" },
]

Preset options

Field Description
name Preset identifier
detect_file Auto-detect by file presence
cwd_pattern Auto-detect by path pattern (supports * suffix)
base_color Hex color for accent line
commands List of command configurations

Command options

Field Description
name Display name
cmd Command to execute (supports $clipboard)
icon Icon name (see available icons below)
cwd Working directory override

Available icons

play, check, wrench, broom, edit, trash, gear, bug, refresh, folder, file, plus, minus, x, search, copy, download, upload, eye, fire, lock, unlock, info, warning, stop, pause, home, user, terminal, code, package

Window controls

Hover over the top area to reveal the title bar:

  • Settings (gear icon): Open config file
  • Corner (corners icon): Move to bottom-right corner / Return to original position
  • Minimize (minus icon): Minimize window
  • Close (x icon): Close application

License

MIT

Commit count: 1

cargo fmt