whatisgithub

What is .tmux?

gpakosz/.tmux — explained in plain English

Analysis updated 2026-06-21

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

In one sentence

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

Shelltmuxawkperl

How does it compare?

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 get it running?

Difficulty · easy Time to first run · 5min

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

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?