Skip to content

ravindran-dev/tmux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TMUX - A Modern Tmux Configuration

A clean, professional tmux setup designed for developers who want speed, clarity, and a beautiful interface.

████████╗███╗   ███╗██╗   ██╗██╗  ██╗
╚══██╔══╝████╗ ████║██║   ██║╚██╗██╔╝
   ██║   ██╔████╔██║██║   ██║ ╚███╔╝ 
   ██║   ██║╚██╔╝██║██║   ██║ ██╔██╗ 
   ██║   ██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗
   ╚═╝   ╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝  

Features

Modern Status Line - System Metrics

  • CPU Usage (%)
  • RAM Usage (Used/Total)
  • Battery Monitoring
  • Clock + Timestamp
  • Minimal clean fonts

Optimized Navigation

  • Ergonomic movements
  • Fast pane operations
  • Intuitive shortcuts

Fastfetch Integration

  • Direct shortcut to launch Fastfetch
  • Image friendly terminal passthrough
  • Prefix + F launches a fastfetch popup

Developer‑Focused

  • Prefix changed to CTRL + Space
  • Designed for daily terminal workflows
  • Performance tuned

Additional features

Animated Welcome Popup

  • Displays an animated ASCII boot sequence
  • Runs automatically when starting a new session
  • Can also be triggered manually with Prefix + a
  • Can also be triggered using reload command Prefix + r

Rectangular Pane Borders

  • Panel header showing command + directory

Professional Status Bar

  • Time and date displayed
  • Section for CPU, Memory, Network integration

Modular Script System

  • Custom metrics scripts stored under ~/.config/tmux/scripts
  • Allows expandable plugin-like architecture

VPN indication

  • Custom script under ~/.config/tmux/scripts/vpn.sh
  • Shows two different variation green when connected, stay in the same theme otherwise.

Installation

1. Clone Repository

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
cd ~/.config
git clone https://github.com/ravindran-dev/tmux.git

2. Source Config

ln -sf ~/.config/tmux/tmux.conf ~/.tmux.conf
tmux -f ~/.config/tmux/tmux.conf
chmod +x ~/.config/tmux/scripts/*.sh

3. Install the plugins

Prefix + I

4. Reload or Restart TMUX

Inside tmux:

Ctrl + Space + r

Outside tmux:

tmux

Folder Structure

~/.config/tmux
├── tmux.conf
└── scripts
    ├── cpu.sh
    ├── mem.sh
    └── bat.sh
    └── ascii.sh
    └── tmux.sh
    └── net.sh
    └── vpn.sh
    └── help.sh

Keymaps

Operation Key Binding Description
Send Prefix Ctrl + Space Send tmux command prefix
Reload tmux config Prefix + r Reload .tmux.conf & restart UI
Open Fastfetch Window Prefix + f Opens new window & executes fastfetch
Split Pane (Vertical) Prefix + - Split pane bottom
Split Pane (Horizontal) Prefix + \ Split pane right
Move Pane (Left) Alt + h Jump to pane left
Move Pane (Down) Alt + j Jump to pane down
Move Pane (Up) Alt + k Jump to pane up
Move Pane (Right) Alt + l Jump to pane right
Resize Pane Left Prefix + ← Shrink left
Resize Pane Right Prefix + → Expand right
Resize Pane Up Prefix + ↑ Expand up
Resize Pane Down Prefix + ↓ Shrink down
New Window Prefix + c Open a new window
Rename Window Prefix + , Rename current window
Rename Session Prefix + . Rename current Session
Kill Pane Prefix + x Close active pane
Kill Window Prefix + X Close entire window
Copy Mode (scroll) Scroll mouse Enter scroll/copy mode
Start copy selection v in copy mode Begin selecting text
Copy selection y in copy mode Copy & exit
Open Welcome popup Prefix+ a opens Welcome popup

System Requirements

Component Required
tmux >= 3.3
Zsh Included
Fastfetch Included
Kitty Terminal

Screenshot

When VPN is not connected

image

When VPN is connected

image

Contributing

Contributions, tweaks, theme variations, and scripts are welcome. Open a PR or create a feature issue.

License

MIT - Use freely for personal & professional work.

Author - Ravindran S

Developer • AI/ML Enthusiast • Linux Power User
Crafting professional CLI experiences with simplicity and power.

🔗 Connect With Me

You can reach me here:

Socials

Contact

About

TMUX - Animated and productivity-focused terminal workspace.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Languages