Removed termpad artifact from .tmux.conf.home

.tmux.conf

@@ -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=default,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,17 +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-style fg=colour8,bg=default # Or your preferred inactive style
-set-option -g window-status-current-style fg=colour2,bg=colour0,bright
-set-option -g window-status-format "#[fg=colour8,bg=default] #I:#W#[fg=colour8,bg=default]#{?window_activity_flag,#[fg=colour11]! ,}"
-set-option -g window-status-current-format "#[fg=colour2,bg=colour0,bright]● #I:#W ●#[fg=colour2,bg=colour0,nobold]"
+#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

.tmux.conf.home

@@ -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)
+

.tmux.conf.work

@@ -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)

README.md

@@ -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.

tmux-menu.template.sh

@@ -1,36 +1,30 @@
 #!/usr/bin/env bash
 #===============================================================================
 #
-#          FILE: tmux-menu.sh
+# 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
 #
-#         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
 #===============================================================================
 
-# 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
@@ -49,30 +43,29 @@ 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'
+#    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
         ;;