Repolode
Submit
gpakosz

gpakosz/.tmux

A self-contained, themeable tmux configuration with a Powerline-style status line, mouse mode, clipboard integration and TPM plugin support.

View on GitHub
Stars
25,469
Forks
3,590
Open issues
24
Last commit
17 days ago

What is it?

Oh my tmux! is a tmux configuration that works out of the box and is designed to be customized through a separate local file. The main configuration file is kept untouched so that upstream updates can be pulled in without losing personal settings, which all go into a .tmux.conf.local copy.

The configuration adds a Powerline-inspired status line with battery, uptime, load average, SSH/Mosh-aware hostname and username, and root or synchronized-pane indicators. It also provides a secondary C-a prefix, Vim-style pane navigation, a command to maximize a pane into its own window, a mouse mode toggle, and copy-to-OS-clipboard support on Linux via xsel, xclip or wl-copy.

It runs on Linux, macOS, FreeBSD, OpenBSD and Windows through WSL, and requires tmux 2.6 or newer. Built-in TPM support lets you enable plugins with a single set -g @plugin line.

Key features

  • 01Powerline-style status line with battery, uptime and load information
  • 02Secondary C-a prefix alongside the default C-b
  • 03Maximize any pane into its own window with prefix +
  • 04Mouse mode toggle for selecting windows, panes and text
  • 05Vim-style pane navigation and copy-mode-vi bindings
  • 06Built-in TPM plugin support

Use cases

  • Setting up a consistent tmux environment across Linux, macOS and WSL machines
  • Customizing tmux status line and keybindings without editing the main config
  • Working on remote servers over SSH or Mosh with clear host indicators
  • Using tmux with a Vim-centric workflow and clipboard integration

Quick start

  1. 1

    Run the automatic installer from the README

  2. 2

    Or clone the repository into your home directory

    git clone --single-branch https://github.com/gpakosz/.tmux.git
  3. 3

    Link the main configuration file

    ln -s -f .tmux/.tmux.conf
  4. 4

    Copy the local customization file

    cp .tmux/.tmux.conf.local .

Things to know

  • Requires tmux 2.6 or newer and a Unix-like environment; Windows is only supported through WSL or Cygwin, which is not recommended.
  • The full Powerline look needs a patched or Powerline-compatible font in your terminal.

In collections

CLI & terminal tools

Topics

#tmux#terminal#dotfiles#configuration#powerline#shell#cli#conf#console#customization

FAQ

What is .tmux?
A self-contained, themeable tmux configuration with a Powerline-style status line, mouse mode, clipboard integration and TPM plugin support. Oh my tmux! is a tmux configuration that works out of the box and is designed to be customized through a separate local file. The main configuration file is kept untouched so that upstream updates can be pulled in without losing personal settings, which all go into a .tmux.conf.local copy.
Is .tmux free to use? What license does it have?
.tmux is open source under the MIT license. Check the license terms before using it in commercial products.
Is .tmux still maintained?
Actively maintained. The last commit to .tmux was on Oct 21, 2026.
What can I use .tmux for?
Setting up a consistent tmux environment across Linux, macOS and WSL machines Customizing tmux status line and keybindings without editing the main config Working on remote servers over SSH or Mosh with clear host indicators Using tmux with a Vim-centric workflow and clipboard integration
How do I install .tmux?
Run the automatic installer from the README Or clone the repository into your home directory: git clone --single-branch https://github.com/gpakosz/.tmux.git Link the main configuration file: ln -s -f .tmux/.tmux.conf Copy the local customization file: cp .tmux/.tmux.conf.local .
Where can I get .tmux?
The source code and installation instructions are on GitHub: https://github.com/gpakosz/.tmux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects