Skip to content
Get packs

Oh my tmux!

A ready-made, pretty tmux configuration file you drop in and customize.gpakosz/.tmux

GitHub Download source
Stars
25.5k
Forks
3.6k
Licence
MIT
Language
Shell
Last update
15 days ago
Type
Dev tool

What it is

Oh my tmux! is a configuration for tmux, a terminal tool that lets you split one terminal window into multiple panes and keep sessions running in the background. It gives tmux a polished look with a Powerline-inspired status bar, and adds conveniences such as a secondary C-a prefix, mouse mode toggling, and maximizing a pane to its own window. Customizations go in a separate .local file so the main config can be left alone.

  • Split terminal windows into panes and keep sessions running after you disconnect
  • Maximize a single pane into its own window with <prefix> +
  • Toggle mouse mode with <prefix> m to resize panes and select text
  • Copy text to the OS clipboard using xsel, xclip, or wl-copy on Linux
  • Open URLs or file paths from terminal output with urlscan, urlview, or PathPicker if installed

Great for

  • Developers who already use tmux and want a better-looking, feature-rich starting config
  • People new to tmux who want a sensible default setup without writing their own
  • Users who work over SSH or Mosh and want hostname and username shown in the status line
  • Vim users who want vi-style key bindings in tmux

Not ideal for

  • People who do not use tmux or the terminal, since it only configures tmux
  • Windows users without WSL or Cygwin, because native Windows is not supported by the README
  • Users who want a minimal config with no visual theme, since the default look is a large part of the project
Step-by-step guide: how to use Oh my tmux!Install, first run, examples, tips and FAQs
Oh my tmux! alternativesOh my tmux! vs Zellijchezmoi vs Oh my tmux!Oh my tmux! vs tmuxinator

How to get it

  1. 1

    Clone and build from source

    You'll need: tmux 2.6 or newer · awk · perl · grep · sed

    Automatic installation

    curl -fsSL "https://github.com/gpakosz/.tmux/raw/refs/heads/master/install.sh#$(date +%s)" | bash

    Manual installation in ~

    cd && git clone --single-branch https://github.com/gpakosz/.tmux.git && ln -s -f .tmux/.tmux.conf && cp .tmux/.tmux.conf.local .
  2. 2

    Run it

    • Install tmux 2.6 or newer on your system
    • Run the automatic or manual installation command from the README
    • Start tmux in a terminal
    • Edit your .tmux.conf.local file to adjust settings, then reload tmux
  3. 3

    Get the most out of it

    • Customize only the .tmux.conf.local file, not the main .tmux.conf
    • Set VISUAL or EDITOR to vim to enable vi-style key bindings
    • Append #!important to a set, bind, or unbind line in the .local file if Oh my tmux! overwrites it
    • Use tmux -f /dev/null -L test to test whether an issue comes from your configuration

Downloads

Source code (.zip)master branch · straight from GitHub

Strengths

  • Installs as plain tmux config files with a documented manual and automatic option
  • Customizations are kept in a separate .local file, making updates easier to manage
  • Large community following with 25k+ stars and an MIT license

Trade-offs

  • Requires tmux 2.6 or newer plus awk, perl, grep, and sed on the system
  • The README warns that editing the main config file leaves you on your own, so customization must follow its structure
  • Some Unicode and emoji characters can display incorrectly depending on terminal and font setup

How it compares

ProjectStarsTypeLevelUpdatedBest for
.tmux (this)25.5kDev toolbeginner15 days agoDevelopers who already use tmux and want a better-looking, feature-rich starting config
tmuxinator13.7kCLIbeginner27 days agoDevelopers who restart the same project setup (editor, server, logs) every day
terminal105kAppbeginner6 days agoWindows users who work in the command line every day and want tabs and rich text
chalk23.3kLibrarybeginner14 days agoNode.js developers building command-line tools that print colored output
chezmoi22.1kDev toolintermediate4 days agoPeople who use more than one computer and want their settings to match
upterm19kAppintermediate7.5 years agoDevelopers who want to try an Electron-based terminal with autocompletion

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.