@zesbe/tmux-ubuntu

🚀 Tmux configuration optimized for Ubuntu servers and VPS

✨ Features

• 🖥️ Remote Optimized - Perfect for SSH connections
• 📱 Touch Screen Support - Works with mobile SSH clients
• 🔄 Persistent Sessions - Detach/reattach without losing work
• ⚡ Server Friendly - Low resource usage
• 🛡️ Stability - Reliable configuration for production

🚀 Quick Install

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

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

# Run configuration
tmux-ubuntu

📖 Usage

After installation:

# Start tmux
tmux

# Or use alias
tm

# List all sessions
tl

# Attach to session
ta session_name

# Kill session
ks session_name

🎮 Controls

Basic Navigation

• Prefix + c - Create new window
• Prefix + w - List windows
• Prefix + 0-9 - Switch to window
• Prefix + d - Detach from session

Pane Management

• Prefix + | - Split window horizontally
• Prefix + - - Split window vertically
• Prefix + Arrow - Switch between panes
• Prefix + x - Close current pane

Mouse/Touch

• Scroll - Mouse wheel or swipe on touch devices
• Click - Position cursor and select panes
• Drag - Select text for copying
• Right Click - Context menu (if supported)

Default Prefix: Ctrl + A

🌐 Remote Access

Persistent Sessions

Create session that survives disconnect:

# Create detached session
tmux new -d -s main

# Attach to session
tmux attach -t main

# Attach from anywhere
ssh user@server -t tmux attach -t main

Best Practices for VPS

1. Always use tmux on servers - Prevent session loss
2. Use meaningful session names - Organize your work
3. Detach properly - Use Prefix + d instead of closing terminal
4. Multiple sessions - Separate work by project

🔧 Server Configuration

The configuration includes:

• Terminal overrides for SSH clients
• Mouse support for remote access
• Touch-friendly scrolling
• Status bar with server info
• Optimized for mobile SSH apps

📊 System Info

The configuration shows:

• Server hostname
• Current time
• Active users
• Session information

🔍 Troubleshooting

Can't scroll?

1. Check mouse is enabled: tmux show -g mouse
2. Ensure your SSH client supports mouse
3. Try reloading: tmux source-file ~/.tmux.conf

Session lost?

1. List existing sessions: tmux ls
2. Reattach: tmux attach -t session_name
3. Check for orphaned sessions: tmux kill-server

Performance issues?

1. Reduce history limit: set -g history-limit 10000
2. Limit active sessions
3. Use server-grade hardware

💡 Pro Tips

1. Auto-attach on login - Add to .bash_profile:

   if [ -z "$TMUX" ]; then
       tmux attach -t main || tmux new -s main
   fi

2. Team sharing - Multiple users can attach to same session

3. Pair programming - Share session with tmux -S /tmp/pair

📦 Requirements

• Ubuntu 18.04+ or compatible
• tmux 1.8+
• SSH access for remote usage

# Install tmux on Ubuntu
sudo apt update
sudo apt install tmux

🔗 Links

• GitHub Repository
• NPM Package
• Report Issues

📄 License

MIT © Zesbe

Built for Ubuntu servers! 🚀✨