🌙 Tokyo Night Tmux Configuration

A professional, minimal, and highly functional tmux configuration with Tokyo Night theme integration, Vim-like keybindings, and productivity enhancements.

✨ Features

• 🎨 Tokyo Night Theme - Stylish and easy-on-the-eyes color scheme
• 🖥️ True Color Support - 24-bit color compatibility
• 🐭 Mouse Integration - Full mouse support for pane/window management
• 📋 System Clipboard - Seamless integration with OS clipboard
• ⏳ Session Persistence - Auto-save/restore sessions with tmux-resurrect
• 🔌 Plugin Ecosystem - Extended functionality through curated plugins
• ⌨️ Vim-style Navigation - Intuitive keybindings for Vim users
• ⚡ Performance Optimized - Fast response times and smooth operation

🚀 Installation

Requirements

• Git 2.4.11+
• tmux 3.2+
• Terminal with True Color support (WezTerm, iTerm2, Kitty, etc.)

Quick Start

# Clone the repository
git clone https://github.com/yourusername/tokyo-night-tmux.git ~/.config/tmux

# Create symlink to tmux config
ln -s ~/.config/tmux/tmux.conf ~/.tmux.conf

# Install TPM (Tmux Plugin Manager)
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# Start tmux and install plugins
tmux new -s tmp
# Inside tmux, press: Ctrl-Space + Shift-I

⌨️ Key Bindings

Session Management

Binding	Action
Ctrl-Space S	Create new session
Ctrl-Space B	Choose session from list
Ctrl-Space D	Detach from session

Window Management

Binding	Action
Ctrl-Space C	Create new window
Ctrl-Space M-c	Close current window
Ctrl-Space N	Next window
Ctrl-Space P	Previous window

Pane Management

Binding	Action
Ctrl-Space %	Split vertically
Ctrl-Space "	Split horizontally
Ctrl-Space Z	Toggle pane zoom
Ctrl-Space X	Close current pane

Navigation

Binding	Action
Ctrl-Space H	Move left (Vim style)
Ctrl-Space J	Move down (Vim style)
Ctrl-Space K	Move up (Vim style)
Ctrl-Space L	Move right (Vim style)
Alt-Arrow	Move between panes (no prefix)

🔌 Plugins Included

• tmux-resurrect - Session persistence
• tmux-continuum - Auto-save sessions
• tmux-fzf - Fuzzy finder integration
• vim-tmux-navigator - Seamless Vim navigation
• tmux-yank - System clipboard integration

🎨 Customization

Change Theme Flavor

# In ~/.tmux.conf
set -g @tokyo-night-tmux_theme 'night'  # Available: night, storm

Modify Status Bar

# Show/hide battery status
set -g @tokyo-night-tmux_show_battery 0

# Change date format
set -g @tokyo-night-tmux_date_format '%Y-%m-%d'

🛠️ Troubleshooting

Q: Colors look wrong in my terminal

# Verify truecolor support
curl -s https://gist.githubusercontent.com/lifepillar/09a44b8cf0f9397465614e622979107f/raw/24-bit-color.sh | bash

Q: Prefix key not working

# Check for conflicting applications
# Try changing escape-time in config:
set -sg escape-time 50

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first.

📄 License

MIT

---

Maintained with ❤️ by [Dev Kraken]