tmux_quick_switch

quick_switch_demo.mp4

A tmux plugin that provides a floating fzf interface for quick window switching with intelligent prefix matching and visual indicators.

Installation

Via TPM (Tmux Plugin Manager)

Add this line to your ~/.tmux.conf:

set -g @plugin 'samuelstranges/tmux_quick_switch'

Then press prefix + I to install.

Manual Installation

1. Clone this repository:

   git clone https://github.com/samuelstranges/tmux_quick_switch.git ~/.tmux/plugins/tmux_quick_switch

2. Add this line to your ~/.tmux.conf:

   run-shell ~/.tmux/plugins/tmux_quick_switch/tmux_quick_switch.tmux

3. Reload tmux configuration:

   tmux source-file ~/.tmux.conf

Usage

• Press your tmux prefix key twice (default: Ctrl-b Ctrl-b) to open the window switcher
• Use arrow keys to navigate through your windows
• Press Enter to select a window
• Press Esc to cancel

Configuration

Key Binding

You can customize the key binding by setting the @quick_switch_key option in your ~/.tmux.conf:

# Use a custom key binding instead of prefix-prefix
set -g @quick_switch_key 'C-w'

Auto-Jump Exact Match

Enable automatic jumping when typing an exact prefix match:

# Enable auto-jump for exact prefix matches
set -g @quick_switch_auto_jump_exact 'on'

Requirements

• fzf must be installed and available in your PATH
• tmux version 3.2 or later (for popup support)

Features

• Centered floating popup window
• Intelligent prefix highlighting - Minimum unique prefixes are highlighted in red and bold
• Visual active window indicator - Shows which window is currently active
• Auto-jump exact matching - Automatically switch to windows when typing exact prefixes (when enabled)
• Configurable key binding - Use custom key combinations or stick with prefix-prefix
• Automatic fzf detection - Graceful error handling if fzf is not installed
• ANSI color support - Beautiful colored output in the fzf interface