Skip to content

Latest commit

 

History

History
69 lines (47 loc) · 1.94 KB

README.md

File metadata and controls

69 lines (47 loc) · 1.94 KB
Raw

🖤 room

A Zellij plugin for quickly searching and switching between tabs.

usage

Usage

  • Tab to cycle through tab list
  • Up and Down to cycle through tab list
  • Enter to switch to the selected tab
  • Start typing to filter the tab list
  • Esc or Ctrl + c to exit

Why?

I rename my tabs so once I have a lot of them I have to start counting and then press Ctrl + t then <tab num>. So I wanted something that let’s me type to filter the tab list and then press enter to jump to the selected tab.

Installation

Download room.wasm from the latest release

  • mkdir -p ~/.config/zellij/plugins/
  • mv room.wasm ~/.config/zellij/plugins/

You don't need to keep room.wasm at this specified location. It's just where I like to keep my zellij plugins.

Quick Install

curl -L "https://github.com/rvcas/room/releases/latest/download/room.wasm" -o ~/.config/zellij/plugins/room.wasm

Keybinding

Add the following to your zellij config somewhere inside the keybinds section:

shared_except "locked" {
    bind "Ctrl y" {
        LaunchOrFocusPlugin "file:~/.config/zellij/plugins/room.wasm" {
            floating true
            ignore_case true
        }
    }
}

You likely already have a shared_except "locked" section in your configs. Feel free to add bind there.

The ignore_case defaults to false if absent. If set to true, filtering the tab names ignores the case of the filter string and the tab name.

Contributing

If you find any issues or want to suggest ideas please open an issue.

Development

Make sure you have rust installed then run:

zellij action new-tab --layout ./dev.kdl