FFFF GitHub - misaelaguayo/zlauncher: A plugin for zellij which runs programs you use often specified in a config file · GitHub
[go: up one dir, main page]

Skip to content
misaelaguayoPublic

About

A plugin for zellij which runs programs you use often specified in a config file

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

zlauncher

A Zellij plugin for running commands you always forget about. I made this because there was one command that I would run very rarely but often enough that I would be annoyed when I had to look for it.

image

Features

  • Configurable list of commands
  • Fuzzy search to filter commands
  • Keyboard navigation (vim-style or arrow keys)

Building

With Nix

nix build

The plugin will be at result/lib/zlauncher.wasm.

Development

With direnv:

direnv allow
cargo build --release

Installation

Reference latest release https://github.com/misaelaguayo/zlauncher/releases/latest/download/zlauncher.wasm in keybinding

Or manually with

nix build
cp result/lib/zlauncher.wasm ~/.config/zellij/plugins/

Usage

Add a keybinding to your Zellij config (~/.config/zellij/config.kdl):

keybinds {
    shared {
        bind "Ctrl Space" {
            LaunchOrFocusPlugin "https://github.com/misaelaguayo/zlauncher/releases/latest/download/zlauncher.wasm" {
                floating true

                // Use KDL raw string syntax r#"..."# for the JSON array
                commands r#"[{"name": "Build", "cmd": "cargo build"}, {"name": "Run", "cmd": "cargo run"}, {"name": "Test", "cmd": "cargo test"}]"#
            }
        }
    }
}

Configuration

Commands are configured as a JSON array using KDL raw string syntax (r#"..."#):

commands r#"[{"name": "Build", "cmd": "cargo build"}, {"name": "Run", "cmd": "cargo run"}]"#

Each command object has:

  • name: Display name shown in the launcher
  • cmd: The command to execute

Controls

Key Action
↑ / k Move selection up
↓ / j Move selection down
Enter Run selected command
Esc Close plugin
Type Filter commands
Backspace Delete filter character

License

MIT

About

A plugin for zellij which runs programs you use often specified in a config file

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0