The tmux-session-dots project is a visual session indicator designed for the tmux status bar. It elegantly displays all tmux sessions as colored dots (●○○), with the current session highlighted for instant recognition. This feature enhances user experience for those who manage multiple tmux sessions by providing immediate visual feedback on the number of active sessions and which session is currently active.

Key Benefits

• Instant Visual Feedback: Understand your session state at a glance while switching between sessions with ease.
• Enhanced Visibility: Clearly see how many sessions are open and identify your current session quickly.

Usage Example

Integrate the plugin seamlessly by adding the following line to your status bar configuration:

set -g status-right "#{session_dots} | %H:%M %p"

This will show the session indicator along with the current time.

Customization Options

Tailor the appearance to suit your preferences:

• Change Color: Modify the default Catppuccin pink to any color of your choice:

  set -g @session-dots-color "#89b4fa"  # Set to Catppuccin blue
  

• Adjust Separator: Customize the separator used between elements:

  set -g @session-dots-separator "  "  # Replace with spaces
  

Quick Session Switching

For enhanced functionality, this plugin can be paired with keybindings to facilitate rapid session changes. Configure your .tmux.conf with these bindings:

# Cycle through sessions using Option + brackets
bind-key -n M-[ switch-client -p
bind-key -n M-] switch-client -n

Performance

The tmux-session-dots plugin leverages client-session-changed hooks to ensure that the status bar updates instantaneously as sessions are switched, replicating the responsiveness of native tmux features.

Overall, tmux-session-dots enhances the tmux experience by transforming the status bar into an intuitive and informative tool for managing multiple sessions effectively.