Skip to content

Windows Widget

Alejandro Amaral edited this page Dec 1, 2024 · 5 revisions

About

image

Enhanced Window Status Indicator for tmux

Key Features:

  • Customizable Window Index Number Style:
    • Choose any icon in active/inactive window.
    • Use tidy or wide layout.
  • Customizable Window Index Number Style:
    • Personalize the appearance of the window index number to match your preferences and theme.
    • Choose from various styles to make the window index visually appealing and easily distinguishable.
  • Pane Index Indicator:
    • Quickly identify the current pane within a window using the pane index indicator.
    • Never lose track of which pane you are working on, even when managing multiple panes simultaneously.
  • Pane Zoomed Indicator:
    • Instantly recognize if a pane is in the zoomed state with the pane zoomed indicator.
    • Easily differentiate between regular and zoomed panes for a clearer overview of your tmux layout.
  • SSH Connection Indicator:
    • Effortlessly identify active SSH connections with the built-in SSH indicator.
    • Particularly useful when managing multiple SSH connections with similar shell prompts.
    • Avoid confusion and quickly locate the desired SSH session among various connections.
  • Stylish and Intuitive Icons:
    • Enhance the visual appeal and readability of the tmux window status with stylish icons.
    • Intuitive icons provide a quick and easy way to understand the status of windows, panes, and SSH connections at a glance.

Configuration

Number styles

Run these commands in your terminal:

tmux set @tokyo-night-tmux_window_id_style <style>
tmux set @tokyo-night-tmux_pane_id_style <style>
tmux set @tokyo-night-tmux_zoom_id_style <style>

Icon styles

tmux set @tokyo-night-tmux_terminal_icon 
tmux set @tokyo-night-tmux_active_terminal_icon 

Spacing

@tokyo-night-tmux_window_tidy_icons 0  # 0 extra spacing | 1 compact mode

Styles

  • none: no style, default font
  • hide: hide number 🆕
  • digital: 7 segment number (🯰...🯹) (needs Unicode support)
  • roman: roman numbers (󱂈...󱂐) (needs nerdfont)
  • fsquare: filled square (󰎡...󰎼) (needs nerdfont)
  • hsquare: hollow square (󰎣...󰎾) (needs nerdfont)
  • dsquare: hollow double square (󰎡...󰎼) (needs nerdfont)
  • super: superscript symbol (⁰...⁹)
  • sub: subscript symbols (₀...₉)
Clone this wiki locally