Compare commits

..

6 Commits

Author SHA1 Message Date
385cce1f5b Removed termpad artifact from .tmux.conf.home 2026-03-03 21:00:39 -05:00
chawley (chawley02)
3061d27a12 Forgot to rename the conf files with leading dot 2026-03-03 14:14:53 -05:00
chawley (chawley02)
0c6628edc0 Updated README.md 2026-03-03 14:13:00 -05:00
chawley (chawley02)
f206ee5333 Changed the way to specify .conf files 2026-03-03 13:59:55 -05:00
chawley (chawley02)
10e4ba07d5 Added ability to specify custom conf file 2026-03-03 13:40:44 -05:00
fb5edb0326 Working tmux window styles 2025-05-07 15:45:19 -04:00
5 changed files with 322 additions and 96 deletions

View File

@@ -71,7 +71,7 @@ set-option -g status-right-length 60 # Set the maximum length of the right
set-option -g status-right "S:#S W:#I P:#P | %b %d %H:%M" # Display session name, window index, pane index, and the date/time on the right
# Status bar style
set-option -g status-style bg=#000000,fg=colour8,bright # Set the background to default (transparent), foreground color, and brightness
set-option -g status-style bg=#000000,fg=grey # Set the background to default (transparent), foreground color, and brightness
#########################################
# Pane Appearance
@@ -90,25 +90,25 @@ set-option -g message-style bg=default,fg=colour13 # Style for messages displaye
# Window Appearance
#########################################
set-option -g window-style bg=default # Default background color for windows
set-option -g window-active-style bg=default # Background color for the active window
set-window-option -g window-style bg=default # Default background color for windows
set-window-option -g window-active-style bg=default # Background color for the active window
#########################################
# Window List Appearance
#########################################
#set-option -g window-status-current-format "#[fg=colour2,bg=colour0]● #I:#W ●#[fg=colour2,bg=colour0]"
#set-option -g window-status-style fg=colour8,bg=default # Or your preferred inactive style
#set-option -g window-status-current-style fg=colour2,bg=default,bright
#set-option -g window-status-format "#[fg=colour8,bg=default] #I:#W#[fg=colour8,bg=default]#{?window_activity_flag,#[fg=colour11]! ,}"
#set-window-option -g window-status-style fg=blue # Or your preferred inactive style
#set-window-option -g window-status-format "#[fg=blue] #I:#W#[fg=blue]#{?window_activity_flag,#[fg=yellow bg=default]!,}"
#set-window-option -g window-status-current-style fg=green,bright
#set-window-option -g window-status-current-format "#[fg=green,bright] #I:#W#[fg=green]"
# Stolen from https://github.com/mhartington/dotfiles/blob/main/config/tmux/tmux-status.conf
# Not active window
set-window-option -g window-status-format "#{?window_activity_flag,#[bg=#8802ad fg=#000000 bold],#[fg=#5e708c bg=default]}#I:#W"
set-window-option -g window-status-format "#{?window_activity_flag,#[bg=#ffff00 fg=#000000 bold],#[fg=#228b22 bg=default]}#I:#W"
# Active window
set-window-option -g window-status-current-format "#[bg=default fg=#059df5]● #I:#W"
set-window-option -g window-status-current-format "#[bg=default fg=#7cfc00]● #I:#W"
#########################################
# Window Titles

119
.tmux.conf.home Normal file
View File

@@ -0,0 +1,119 @@
#########################################
# Basic Settings and Prefix
#########################################
set-option -g prefix C-a # Set Ctrl-a as the prefix key
unbind C-b # Unbind the default Ctrl-b prefix
set -sg escape-time 1 # Shorten command delay for faster responsiveness
#########################################
# Terminal and Display
#########################################
set-option -g default-terminal "tmux-256color" # Force tmux to use 256 colors if supported by the terminal
#########################################
# History and Indexing
#########################################
set-option -g history-limit 10000 # Set the scrollback history limit to 10,000 lines
set-option -g base-index 1 # Start window indexing at 1 (instead of 0)
set-option -g pane-base-index 1 # Start pane indexing at 1 (instead of 0)
#########################################
# Key Bindings
#########################################
# Reload tmux configuration
bind r source-file ~/.tmux.conf \; display "Reloaded!"
# Window Management
bind Tab next-window # Cycle to the next window
bind , command-prompt "rename-window '%%'" # Open a prompt to rename the current window
# Pane Management
bind | split-window -h # Split the current window horizontally
bind - split-window -v # Split the current window vertically
# Pane Selection (Vi-style movement)
bind h select-pane -L # Select the pane to the left
bind j select-pane -D # Select the pane below
bind k select-pane -U # Select the pane above
bind l select-pane -R # Select the pane to the right
# Pane Resizing
bind -r H resize-pane -L 2 # Resize the current pane 2 cells to the left (repeatable with -r)
bind -r J resize-pane -D 2 # Resize the current pane 2 cells down (repeatable with -r)
bind -r K resize-pane -U 2 # Resize the current pane 2 cells up (repeatable with -r)
bind -r L resize-pane -R 2 # Resize the current pane 2 cells to the right (repeatable with -r)
#########################################
# Visual Notifications
#########################################
set-option -g monitor-activity on # Enable monitoring of activity in other windows
set-option -g visual-activity on # Enable visual notification of activity in other windows
#########################################
# Status Bar
#########################################
set-option -g status on # Turn the status bar on
set-option -g status-interval 5 # Set the status bar update frequency to 5 seconds
set-option -g status-justify centre # Justify the window list to the left
# Left side of the status bar
set-option -g status-left-length 70 # Set the maximum length of the left side of the status bar
set-option -g status-left "#h ◆" # Display the hostname on the left, followed by some visual separators
# Right side of the status bar
set-option -g status-right-length 60 # Set the maximum length of the right side of the status bar
set-option -g status-right "S:#S W:#I P:#P | %b %d %H:%M" # Display session name, window index, pane index, and the date/time on the right
# Status bar style
set-option -g status-style bg=#000000,fg=grey # Set the background to default (transparent), foreground color, and brightness
#########################################
# Pane Appearance
#########################################
set-option -g pane-border-style bg=colour0,fg=colour8 # Style for inactive pane borders
set-option -g pane-active-border-style bg=colour0,fg=colour2 # Style for the active pane border
#########################################
# Message Appearance
#########################################
set-option -g message-style bg=default,fg=colour13 # Style for messages displayed in the tmux command line
#########################################
# Window Appearance
#########################################
set-window-option -g window-style bg=default # Default background color for windows
set-window-option -g window-active-style bg=default # Background color for the active window
#########################################
# Window List Appearance
#########################################
#set-window-option -g window-status-style fg=blue # Or your preferred inactive style
#set-window-option -g window-status-format "#[fg=blue] #I:#W#[fg=blue]#{?window_activity_flag,#[fg=yellow bg=default]!,}"
#set-window-option -g window-status-current-style fg=green,bright
#set-window-option -g window-status-current-format "#[fg=green,bright]● #I:#W ●#[fg=green]"
# Stolen from https://github.com/mhartington/dotfiles/blob/main/config/tmux/tmux-status.conf
# Not active window
set-window-option -g window-status-format "#{?window_activity_flag,#[bg=#ffff00 fg=#000000 bold],#[fg=#228b22 bg=default]}#I:#W"
# Active window
set-window-option -g window-status-current-format "#[bg=default fg=#7cfc00]● #I:#W"
#########################################
# Window Titles
#########################################
set-option -g set-titles on # Enable automatic window titles
set-option -g set-titles-string '#H:#S.#I.#P #W #T' # Format string for window titles (hostname:session.window_index.pane_index window_number window_name)

118
.tmux.conf.work Normal file
View File

@@ -0,0 +1,118 @@
#########################################
# Basic Settings and Prefix
#########################################
set-option -g prefix C-a # Set Ctrl-a as the prefix key
unbind C-b # Unbind the default Ctrl-b prefix
set -sg escape-time 1 # Shorten command delay for faster responsiveness
#########################################
# Terminal and Display
#########################################
set-option -g default-terminal "tmux-256color" # Force tmux to use 256 colors if supported by the terminal
#########################################
# History and Indexing
#########################################
set-option -g history-limit 10000 # Set the scrollback history limit to 10,000 lines
set-option -g base-index 1 # Start window indexing at 1 (instead of 0)
set-option -g pane-base-index 1 # Start pane indexing at 1 (instead of 0)
#########################################
# Key Bindings
#########################################
# Reload tmux configuration
bind r source-file ~/.tmux.conf \; display "Reloaded!"
# Window Management
bind Tab next-window # Cycle to the next window
bind , command-prompt "rename-window '%%'" # Open a prompt to rename the current window
# Pane Management
bind | split-window -h # Split the current window horizontally
bind - split-window -v # Split the current window vertically
# Pane Selection (Vi-style movement)
bind h select-pane -L # Select the pane to the left
bind j select-pane -D # Select the pane below
bind k select-pane -U # Select the pane above
bind l select-pane -R # Select the pane to the right
# Pane Resizing
bind -r H resize-pane -L 2 # Resize the current pane 2 cells to the left (repeatable with -r)
bind -r J resize-pane -D 2 # Resize the current pane 2 cells down (repeatable with -r)
bind -r K resize-pane -U 2 # Resize the current pane 2 cells up (repeatable with -r)
bind -r L resize-pane -R 2 # Resize the current pane 2 cells to the right (repeatable with -r)
#########################################
# Visual Notifications
#########################################
set-option -g monitor-activity on # Enable monitoring of activity in other windows
set-option -g visual-activity on # Enable visual notification of activity in other windows
#########################################
# Status Bar
#########################################
set-option -g status on # Turn the status bar on
set-option -g status-interval 5 # Set the status bar update frequency to 5 seconds
set-option -g status-justify centre # Justify the window list to the left
# Left side of the status bar
set-option -g status-left-length 70 # Set the maximum length of the left side of the status bar
set-option -g status-left "#h ◆" # Display the hostname on the left, followed by some visual separators
# Right side of the status bar
set-option -g status-right-length 60 # Set the maximum length of the right side of the status bar
set-option -g status-right "S:#S W:#I P:#P | %b %d %H:%M" # Display session name, window index, pane index, and the date/time on the right
# Status bar style
set-option -g status-style bg=#000000,fg=colour8,bright # Set the background to default (transparent), foreground color, and brightness
#########################################
# Pane Appearance
#########################################
set-option -g pane-border-style bg=colour0,fg=colour8 # Style for inactive pane borders
set-option -g pane-active-border-style bg=colour0,fg=colour2 # Style for the active pane border
#########################################
# Message Appearance
#########################################
set-option -g message-style bg=default,fg=colour13 # Style for messages displayed in the tmux command line
#########################################
# Window Appearance
#########################################
set-option -g window-style bg=default # Default background color for windows
set-option -g window-active-style bg=default # Background color for the active window
#########################################
# Window List Appearance
#########################################
#set-option -g window-status-current-format "#[fg=colour2,bg=colour0]● #I:#W ●#[fg=colour2,bg=colour0]"
#set-option -g window-status-style fg=colour8,bg=default # Or your preferred inactive style
#set-option -g window-status-current-style fg=colour2,bg=default,bright
#set-option -g window-status-format "#[fg=colour8,bg=default] #I:#W#[fg=colour8,bg=default]#{?window_activity_flag,#[fg=colour11]! ,}"
# Stolen from https://github.com/mhartington/dotfiles/blob/main/config/tmux/tmux-status.conf
# Not active window
set-window-option -g window-status-format "#{?window_activity_flag,#[bg=#8802ad fg=#000000 bold],#[fg=#5e708c bg=default]}#I:#W"
# Active window
set-window-option -g window-status-current-format "#[bg=default fg=#059df5]● #I:#W"
#########################################
# Window Titles
#########################################
set-option -g set-titles on # Enable automatic window titles
set-option -g set-titles-string '#H:#S.#I.#P #W #T' # Format string for window titles (hostname:session.window_index.pane_index window_number window_name)

View File

@@ -1,74 +1,70 @@
---
filecreated:
fileupdated: 2025-04-16
filetags: [readme]
CREATED : 2026-03-03
UPDATED : 2026-03-03
AUTHOR : chawley
---
# tmux-menu.sh
# TMUX Hack Session Launcher
A hack tmux menu script to manage multiple tmux sessions
A Bash script designed to manage and automate pre-defined tmux-sessions. This script allows you to launch complex development or administration environments - complete with multiple windows and SSH connections - using a single command.
---
REQ: tmux v3+
## Features
- **Automated Session Creation**: Checks if a session exists; if not, it creates it with your pre-defined windows and layouts.
- **Environment Nesting Protection**: Prevents launching a new session if you are already inside an active tmux environment.
- **Custom Configuration Support**: Automatically sources your `$HOME/.tmux.conf`.
- **Session Attaching**: If a requested session is already running, the script simply attaches you to it.
- **Fallback Discovery**: Provides an error message and lists all currently active sessions if an invalid name is provided.
---
## Need
## Prerequisites
After I discovered tmux I searched for a way to manage multiple groups of tmux sessions under one unified script. Not finding anything (or maybe just not looking well enough) I decided to write my own. It's not pretty, but I've been using for a couple of years now and it's become an integral part of my workflow.
- **tmux**: Ensure `tmux` is installed and available in your `$PATH`.
- **SSH Config (Optional)**: For windows that execute SSH commands, ensure your SSH keys or config are set up for seamless connections.
My setup works this way:
---
Imagine you have multiple SSH connections
## Installation
- web-dev
- web-prod
- database-dev
- database-prod
1. Copy the script to a directory in your `$PATH` (e.g., `~/bin` or `/usr/local/bin`).
2. Rename it to something short, like `tm`.
3. Make the script executable:
```bash
chmod +x ~/bin/tm
```
and you want to group them together in similar groups.
---
With this script you can name collections of sessions and switch between them easily with just a few keystrokes.
## Usage
Let's see an example using the above connections:
Run the script followed by the name of the pre-defined session:
```bash
case $session in
web)
if [[ $tcheck == 0 ]]; then
tmux new-session -d -s web
tmux rename-window 'local'
tmux new-window -t 1 -n 'root@web-dev' 'exec ssh root@web-dev.example.org'
tmux new-window -t:2 -n 'user@web-prod' 'exec ssh user@webprod.example.org'
fi
tmux attach-session -t web
;;
case $session in
database)
if [[ $tcheck == 0 ]]; then
tmux new-session -d -s database
tmux rename-window 'local'
tmux new-window -t 1 -n 'root@database-dev' 'exec ssh root@databasedev.example.org'
tmux new-window -t:2 -n 'user@database-prod' 'exec ssh user@wdatabase.example.org'
fi
tmux attach-session -t database
;;
tm mine
```
Calling the script with a pre-determined session name (ex: `./tmux-menu.sh web` or `./tmux-menu.sh database`) firstchecks to see if there is already a session group with that name. If not, it creates a new group with the commands youspecify and names each connection in tmux.
If the session group *does* already exist, it simply switches you to that group.
If you alias `tmux-menu.sh` to something shorter (like `tm`), switching between active sessions is as easy as `Ctrl-A + d` (to detach) and `tm web` (to attach or create the web group).
Killing session groups is as easy as `tmux-session kill -t web`.
If no session name is provided, or the name doesn't match a case in the script, it will display an error and list all currently active tmux sessions.
---
## Use
## Configuration
I've found that I use this script on different servers with different configurations. So I copy the `tmux-menu.template.sh` to `$HOME/tmux-menu.sh` and then alias that to `tm`.
To add a new session, add a new case stanza inside the `case $session in` block.
I also include my `.tmux.conf` file with comments about what does what. If you choose to use it, make sure to copy it to your home directory.
### Template
```bash
session_name)
if [[ $tcheck == 0 ]]; then
tmux -f "${TMUX_CONF}" new-session -d -s session_name
tmux -f "${TMUX_CONF}" rename-window 'initial_window'
tmux -f "${TMUX_CONF}" new-window -t:1 -n 'second_window' 'command_to_run'
fi
tmux attach-session -t session_name
;;
```
### Script Variables
- `TMUX_CONF`: Defaults to `$HOME/.tmux.conf`. Modify this variable if your configuration file is located elsewhere.

View File

@@ -1,36 +1,30 @@
#!/usr/bin/env bash
#===============================================================================
#
# FILE: tmux-menu.sh
#
# USAGE: ./tmux-menu.sh <session-name>
#
# DESCRIPTION: A hack script I wrote to help me manage pre-defined
# tmux-sessions
#
# OPTIONS:
# REQUIREMENTS: tmux
# NOTES: the cool down arrows in line 43? <ctrl-k> -v (see: digraphs)
# AUTHOR: C Hawley
# ORGANIZATION:
# CREATED: 2015-09
# REVISION: Mon 16 Oct 2017 05:28:00 PM EDT
# CREATED : 2015-09-09
# UPDATED : 2026-03-03
# USAGE :
# DESC : A hack script I wrote to help me manage pre-defined
# tmux-sessions
# NOTES :
# AUTHOR : chawley
#
#===============================================================================
# check for command line argument
# Tips from:
# http://stackoverflow.com/questions/7832080/test-if-a-variable-is-set-in-bash-when-using-set-o-nounset
if [ -z "${1:-}" ]; then
session="undefined"
else
session=$1
fi
# Change this to your tmux config file if it's not in the home directory or named differently
TMUX_CONF="-f $HOME/.tmux.conf"
echo ""
echo ""
echo "##################################"
echo "----------------------------------"
echo "TMUX Hack Session Launcher"
echo "##################################"
echo "----------------------------------"
echo "Launching Session: $session"
# NO TMUX NESTING ALLOWED
@@ -48,37 +42,36 @@ tcheck=$(tmux list-sessions | grep -c "${session}") # check if session is activ
# sample session definition
#
# case $session in
# analytics) # <- session name
# if [[ $tcheck == 0 ]]; then # <- check if it's already running
# tmux new-session -d -s analytics # <- if not, create it
# tmux rename-window 'localhost' # <- rename the first window (local)
# # ↓↓ define additional windows ↓↓
# tmux new-window -t:1 -n 'lasis01' 'exec ssh lasis01'
# tmux new-window -t:2 -n 'lasis01dev' 'exec ssh lasis01dev'
# tmux new-window -t:3 -n 'ldssbox01' 'exec ssh ldssbox01'
# tmux new-window -t:4 -n 'lpdprod01' 'exec ssh lpdprod01'
# tmux new-window -t:5 -n 'ldatalake01' 'exec ssh ldatalake01'
# tmux new-window -t:6 -n 'lsandbox' 'exec ssh lsandbox'
# case $session in
# analytics) # <- session name
# if [[ $tcheck == 0 ]]; then # <- check if it's already running
# tmux new-session -d -s analytics # <- if not, create it
# tmux -f "${TMUX_CONF}" rename-window 'localhost' # <- rename the first window (local)
# # ↓↓ --- define additional windows --- ↓↓
# tmux -f "${TMUX_CONF}" new-window -t:1 -n 'lasis01' 'exec ssh lasis01'
# tmux -f "${TMUX_CONF}" new-window -t:2 -n 'lasis01dev' 'exec ssh lasis01dev'
# tmux -f "${TMUX_CONF}" new-window -t:3 -n 'ldssbox01' 'exec ssh ldssbox01'
# tmux -f "${TMUX_CONF}" new-window -t:4 -n 'lpdprod01' 'exec ssh lpdprod01'
# tmux -f "${TMUX_CONF}" new-window -t:5 -n 'ldatalake01' 'exec ssh ldatalake01'
# tmux -f "${TMUX_CONF}" new-window -t:6 -n 'lsandbox' 'exec ssh lsandbox'
# fi
# tmux attach-session -t analytics # <- if window active, switch to it
# ;;
case $session in
mine)
if [[ $tcheck == 0 ]]; then
tmux new-session -d -s mine
tmux rename-window 'local(aristotle)'
tmux new-window -t 1 -n 'root@vps' 'exec ssh root@vps.example.org'
tmux new-window -t:2 -n 'chawley@phaedrus' 'exec ssh chawley@phaedrus'
tmux new-window -t:3 -n 'chawley@homer' 'exec ssh chawley@homer.simpsons.net'
tmux -f "${TMUX_CONF}" new-session -d -s mine
tmux -f "${TMUX_CONF}" rename-window 'local(aristotle)'
tmux -f "${TMUX_CONF}" new-window -t 1 -n 'root@vps' 'exec ssh root@vps.example.org'
tmux -f "${TMUX_CONF}" new-window -t:2 -n 'chawley@phaedrus' 'exec ssh chawley@phaedrus'
tmux -f "${TMUX_CONF}" new-window -t:3 -n 'chawley@homer' 'exec ssh chawley@homer.simpsons.net'
fi
tmux attach-session -t mine
;;
# add more sessions here inside a case stanza. Start with a session name and end with ';;'
# add more sessions here inside a case stanza. Start with a session name and end with ';;'
*)
echo "### ERROR No Such Session ###"
echo "Usage: tm <session_name>"