gitwtfhub

wtf is .tmux?

gpakosz/.tmux — explained in plain English

Analysis updated 2026-06-21

★ 24,841ShellAudience · developerComplexity · 2/5Setup · easy

TL;DR

Oh my tmux! is a drop-in tmux configuration that adds a polished status bar, smarter keyboard shortcuts, mouse support, and clipboard integration to your terminal without any manual setup.

Mindmap

mindmap
  root((oh-my-tmux))
    What it does
      tmux config package
      Status bar styling
      Shortcut improvements
    Features
      Mouse support
      Clipboard integrate
      URL picker
      SSH pane splitting
    Customization
      Local override file
      Safe updates
      Powerline style bar
    Platforms
      Linux
      macOS
      WSL Windows

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Replace a blank tmux setup with a polished status bar showing battery, uptime, and hostname in minutes.

REASON 2

Use the layered config system to add personal tmux tweaks without losing them when the project updates.

REASON 3

Enable SSH-aware pane splitting that automatically reconnects split panes to remote servers.

REASON 4

Toggle mouse support on and off with a keyboard shortcut for pairing sessions or copy-paste workflows.

What's in the stack?

Shelltmuxawkperl

How it stacks up

gpakosz/.tmuxlxgw/lxgwwenkaidylanaraps/neofetch
Stars24,84124,18023,653
LanguageShellShellShell
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencedeveloperdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires tmux 2.6 or newer and standard Unix tools including awk and perl.

Wtf does this do

Oh my tmux! is a ready-to-use configuration package for tmux, a terminal multiplexer, a tool that lets you split one terminal window into multiple panes, run programs in the background, and keep sessions alive even after you disconnect. Instead of spending hours tweaking tmux from scratch, you drop in this configuration and get a polished, Powerline-styled status bar (the decorative bar at the bottom of your terminal showing battery, uptime, hostname, and more), smarter keyboard shortcuts, and a handful of extras out of the box. The setup works by layering two files: a main configuration file you never touch, and a local copy you customize freely. This means you can update the project without losing your personal tweaks. Key features include mouse support toggle, the ability to pop any panel into a full window and back again, clipboard integration, URL picker integration, and SSH-aware pane splitting that reconnects automatically to remote servers. You would reach for this if you live in the terminal and want tmux to look good and behave sensibly without manual configuration work. It runs on Linux, macOS, OpenBSD, and Windows via WSL or Cygwin, and requires only standard Unix tools like awk and perl alongside tmux version 2.6 or newer.

Yoink these prompts

Prompt 1
I've installed oh-my-tmux and want to customize the status bar to show my current Git branch and CPU usage. Where do I add those to the local override file without touching the main config?
Prompt 2
Show me how to set up oh-my-tmux on a remote Linux server I SSH into, and keep my local config in sync with it.
Prompt 3
Help me add a custom tmux keybinding in the .tmux.conf.local file that opens a new split pane in the same directory as the current pane.
Prompt 4
I upgraded tmux and my oh-my-tmux status bar looks broken. What are the common compatibility issues between oh-my-tmux and tmux versions above 3.x?

Frequently asked questions

wtf is .tmux?

Oh my tmux! is a drop-in tmux configuration that adds a polished status bar, smarter keyboard shortcuts, mouse support, and clipboard integration to your terminal without any manual setup.

What language is .tmux written in?

Mainly Shell. The stack also includes Shell, tmux, awk.

How hard is .tmux to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is .tmux for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane