https://github.com/vhstack/tmuxpp
Advanced Terminal Setup for Devs and Admins
https://github.com/vhstack/tmuxpp
bash config configuration developer-tools development multiplexer terminal tmux-conf tpm tpm-plugin truecolor
Last synced: 29 days ago
JSON representation
Advanced Terminal Setup for Devs and Admins
- Host: GitHub
- URL: https://github.com/vhstack/tmuxpp
- Owner: vhstack
- Created: 2025-03-21T11:23:37.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-03T16:28:08.000Z (12 months ago)
- Last Synced: 2025-08-29T14:51:41.650Z (9 months ago)
- Topics: bash, config, configuration, developer-tools, development, multiplexer, terminal, tmux-conf, tpm, tpm-plugin, truecolor
- Language: Shell
- Homepage:
- Size: 5.62 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
Awesome Lists containing this project
README
# Tmux Configuration
This Tmux configuration is designed for enhanced usability, featuring intuitive keybindings, true-color support,
and a selection of useful plugins.
The example script `sample_run.sh` automatically sets up and launches a session with multiple windows.
## 📥 Installation
### 1. Install Tmux
If Tmux is not yet installed:
```bash
sudo apt install tmux # Debian/Ubuntu
brew install tmux # macOS
```
For more information, see the [**Tmux Wiki**](https://github.com/tmux/tmux/wiki).
### 2. Set the TERM Variable
In your `~/.bashrc`, set the `TERM` variable:
```bash
export TERM=xterm-256color
```
### 3. Clone the Repository and Apply the Configuration
```bash
git clone --depth 1 https://github.com/vhstack/tmuxpp.git ~/.tmux
rm -rf ~/.tmux/.git ~/.tmux/assets ~/.tmux/README*.md
ln -s ~/.tmux/tmux.conf ~/.tmux.conf
```
### 4. Install TPM (Tmux Plugin Manager)
```bash
git clone --depth 1 https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
rm -rf ~/.tmux/plugins/tpm/.git
```
More details can be found in the[**TPM-Repository**](https://github.com/tmux-plugins/tpm).
### 5. Install Plugins
Start Tmux and press:
```tmux
Prefix + I # Installs the plugins
```
## ⌨️ Keybindings
- **Prefix Key:** `Ctrl + A` (instead of `Ctrl + B`)
- **Window Management:**
- `Prefix + +` → Create a new session
- `Prefix + c` → Create a new window
- `Prefix + ,` → Rename the window
- `Prefix + x` → Close the window
- `Prefix + $` → Rename the session
- `Prefix + |` → Split pane vertically
- `Prefix + -` → Split pane horizontally
- `Prefix + N` → Detach pane
- **Navigation:**
- `Prefix + ←,→,↑,↓` → Navigate between panes
- `Alt + →` / `Alt + ←` → Switch between windows
- `Ctrl + Alt + →` / `Ctrl + Alt + ←` → Move windows
- **Resize Panes:**
- `Prefix + j/k/h/l` → Resize panes
- `Prefix + m` → Maximize/restore pane
- **Reload Configuration:**
- `Prefix + r`
## 📦 Plugins
Managed using TPM:
- `tmux-plugins/tmux-sensible` → Standard config
- `christoomey/vim-tmux-navigator` → Vim-style pane navigation
- `tmux-plugins/tmux-sessionist` → Session management
## 🎨 Color & Theme
- True-color support enabled
- `vhstack` theme is enabled
- `catppuccin` theme is included
---
You're now ready to work more efficiently in your Tmux sessions! 🚀