Skip to content

README.en.md

Latest commit

Β 

History

History
97 lines (71 loc) Β· 2.79 KB

README.en.md

File metadata and controls

97 lines (71 loc) Β· 2.79 KB

Deutsch English Русский

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.

Screenshot

πŸ“₯ Installation

1. Install Tmux

If Tmux is not yet installed:

sudo apt install tmux    # Debian/Ubuntu
brew install tmux        # macOS

For more information, see the Tmux Wiki.

2. Set the TERM Variable

In your ~/.bashrc, set the TERM variable:

export TERM=xterm-256color

3. Clone the Repository and Apply the Configuration

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)

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 theTPM-Repository.

5. Install Plugins

Start Tmux and press:

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! πŸš€