@zesbe/tmux-linux

🐧 Tmux configuration optimized for Linux desktop development

✨ Features

• 💻 Desktop Optimized - Perfect for Linux desktop environments
• 📋 System Clipboard - Seamless copy/paste with xclip
• 🎨 Enhanced UI - Beautiful status bar and colors
• 🔧 Dev Friendly - Productivity shortcuts and tools
• 🔌 Plugin Ready - TPM (Tmux Plugin Manager) support

🚀 Quick Install

# Install globally
npm install -g @zesbe/tmux-linux

# Or install locally
npm install @zesbe/tmux-linux

# Run configuration
tmux-linux

📖 Usage

After installation:

# Start tmux
tmux

# Or use alias
tm

# Edit configuration
tconf

# Reload configuration
tsrc

# List sessions
tl

🎮 Controls

Window Management

• Prefix + c - Create new window
• Prefix + w - List windows
• Prefix + , - Rename window
• Prefix + & - Close window

Pane Management

• Prefix + | - Split horizontal
• Prefix + - - Split vertical
• Prefix + h/j/k/l - Navigate panes
• Prefix + x - Close pane
• Prefix + z - Zoom/unzoom pane

Copy Mode (Vi-style)

• Prefix + [ - Enter copy mode
• v - Start selection
• y - Copy to clipboard
• r - Rectangle toggle
• p - Paste from buffer

Productivity Shortcuts

• Prefix + e - Edit config in new window
• Prefix + r - Reload configuration
• C-h/C-l - Navigate windows

Default Prefix: Ctrl + A

🔧 Features

System Integration

• Clipboard Support - Copy to system clipboard with xclip
• Desktop Detection - Auto-detects your desktop environment
• Path Awareness - New windows preserve current directory

Visual Enhancements

• 256 Colors - Full color terminal support
• Status Bar - Shows hostname, time, and session info
• Window Status - Visual indicators for active windows
• Pane Borders - Color-coded active pane

Development Tools

• Config Editor - Quick edit configuration
• Plugin Support - Ready for TPM plugins
• Session Management - Easy session switching

🔌 Plugins (Optional)

Enhance with Tmux Plugin Manager (TPM):

# Install TPM
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# Install plugins (Prefix + I)
# Update plugins (Prefix + U)

# Recommended plugins:
# - tmux-sensible
# - tmux-yank
# - tmux-resurrect

📋 Requirements

• Linux distribution (Ubuntu, Fedora, Arch, etc.)
• tmux 1.8+
• Node.js (for npm install)
• xclip (for clipboard support)

Install Dependencies

# Ubuntu/Debian
sudo apt update
sudo apt install tmux xclip

# Fedora
sudo dnf install tmux xclip

# Arch Linux
sudo pacman -S tmux xclip

# openSUSE
sudo zypper install tmux xclip

🎨 Desktop Environment Support

Works with:

• GNOME
• KDE Plasma
• XFCE
• i3wm
• Sway
• And more!

💡 Pro Tips

1. Auto-start tmux - Add to .bashrc:

   [ -z "$TMUX" ] && exec tmux

2. Nested tmux - Use different prefix:

   bind -T root C-b send-prefix

3. Custom status - Modify status bars:

   set -g status-right "Vol: #(amixer get Master | grep -o [0-9]*%) | %H:%M"

4. Project sessions - Use project names:

   tmux new -s myproject

🔍 Troubleshooting

Clipboard not working?

# Install xclip
sudo apt install xclip

# Test it
echo "test" | xclip -selection clipboard

Colors not showing?

# Set terminal type
export TERM=xterm-256color

# Check support
tic -e xterm-256color

Performance issues?

# Reduce history
set -g history-limit 10000

# Disable activity monitoring
setw -g monitor-activity off

🔗 Links

• GitHub Repository
• NPM Package
• TMUX Plugin Manager
• Report Issues

📄 License

MIT © Zesbe

Built for Linux developers! 🐧✨