What is tmux?
tmux is the terminal multiplexer: it runs many shells inside one terminal, split into windows and panes, and keeps them running after you disconnect. A tmux session lives in a server process, not in your terminal window, so you can detach from it, close the window or lose the ssh connection, and attach to it again later with every program still running exactly where you left it. Inside a session you open windows like tabs, split each one into panes side by side or on top of each other, scroll back and copy text with the keyboard, and drive all of it from a config file or from scripts. tmux is written in C, started by Nicholas Marriott, and is ISC licensed.
apt upgrade.
⚡ Key Features of tmux
🔌 Detach and Reattach
Start a long build or a server process inside tmux, detach, log out or lose the network, and attach again from anywhere: the session and everything in it kept running while you were gone.
🪟 Windows and Panes
Each session holds windows like tabs, and each window splits into panes, so an editor, a shell and a log tail share one screen. Panes resize, zoom to full size and rearrange with a few keys.
🎈 Floating and Modal Panes
tmux 3.8 adds floating panes that sit above the layout and modal panes that take over the window until you close them, for a quick command or a picker without disturbing your splits.
📋 Copy Mode and Clipboard
Scroll back through a pane's history, search it and select text with vi or emacs keys. Copied text reaches your desktop clipboard through OSC 52, even from a tmux running on a remote server.
🖼️ Images in the Terminal
This build has sixel support enabled, so programs that draw sixel images show them inside a tmux pane when your terminal supports sixel too.
🧰 Scriptable and Configurable
Every action is a command: bind it to a key in ~/.tmux.conf, or run it from a shell script to build a whole session layout in one go. Plugin managers and session tools build on exactly that.
apt upgrade keeps you on the latest version.
📦 Installation from deb.griffo.io
Step 1: Add Repository
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 There is an always-free mirror. deb-free.griffo.io serves packages free forever, no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries cliamp, Forgejo Runner, Ghostty, lazydocker, Oh My Posh, Uncloud and Zed; tmux is not one of them, so the repository above is the only way to get it today, ask and it can be enrolled.
🧩 About the extrepo option. extrepo is Debian's own tool for external repositories: it writes the sources file and installs the signing key for you, checking the key against signed metadata first. This repository is registered with it as griffo, and the always-free mirror as griffo-free, so on Debian (bookworm, trixie, forky and sid) the commands above are the whole setup.
extrepo sets up the sources file and the key only, so a subscription's credentials still go in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu is not covered, because extrepo publishes metadata for Debian suites only: there, use the sudo or root commands.
Step 2: Install tmux
# Install latest tmux (replaces the distribution's older tmux in place)
sudo apt install tmux
# Verify installation
dpkg -s tmux | grep Version# Install latest tmux (replaces the distribution's older tmux in place)
apt install tmux
# Verify installation
dpkg -s tmux | grep VersionStep 3: First run
# Upgraded from the distribution's tmux? Sessions that were already running
# keep the old server until you exit them; this stops them all at once
tmux kill-server
# Start a named session
tmux new -s work
# Detach with Ctrl-b d, then attach again later, from here or over ssh
tmux attach -t work🎯 Basic Usage Examples
Sessions, windows and panes:
# List the running sessions
tmux ls
# Inside tmux, the prefix is Ctrl-b, followed by:
# c new window n / p next / previous window
# % split left/right " split top/bottom
# arrows move between panes z zoom the current pane
# [ copy mode, to scroll back and select text
# d detachScripting a layout:
# A detached session with an editor on the left and a shell on the right
tmux new-session -d -s dev -n code
tmux split-window -h -t dev:code
tmux send-keys -t dev:code.0 'nvim' Enter
tmux attach -t dev
# Reload your configuration without restarting anything
tmux source-file ~/.tmux.confKeeping it current:
# tmux updates with the rest of the system
sudo apt update && sudo apt upgrade
# Which version is installed, and which is the newest available
apt policy tmux
# Running sessions keep the old server; exit them or stop it to switch
tmux kill-server# tmux updates with the rest of the system
apt update && apt upgrade
# Which version is installed, and which is the newest available
apt policy tmux
# Running sessions keep the old server; exit them or stop it to switch
tmux kill-server🔧 Tool Integrations
Because the package is called tmux, everything built on tmux keeps working after the upgrade:
- ssh: run tmux on the server, not on your laptop, and a dropped connection only detaches you;
ssh -t host tmux attachpicks the session up again - Plugins: tmux-plugin-manager (tpm) and the plugins it installs load from
~/.tmux.confexactly as before - Session tools: tmuxinator and byobu drive the
tmuxcommand, so they get the new version with nothing to reconfigure - Clipboard: with OSC 52, text copied in copy mode reaches the clipboard of the terminal you are sitting at, even through ssh
- Terminal features: ncurses 6.6 is linked statically, so the clipboard, cursor colour and style, and styled underlines behave the same on every supported release
- systemd: built with systemd support, like Debian's own package, and its sockets in
/tmpare kept safe fromsystemd-tmpfilescleanup the same way - Documentation: the tmux wiki at github.com/tmux/tmux/wiki covers getting started, the FAQ and every option
🚀 Why Choose deb.griffo.io?
- Official Debian: ships tmux 3.5a in trixie, frozen for the life of its release
- Upstream downloads: tmux publishes source only, so there is no ready-made binary to download for any release
- Building from source: a C toolchain plus the libevent and ncurses development packages, a configure and make for every release, and nothing that updates it for you
- deb.griffo.io: latest version with automatic updates
- ✅ Same Package Name as Debian: the package is
tmux, exactly what the Debian archive calls it, so this repository upgrades the stock tmux in place onapt upgrade - ✅ Built From Every Tagged Release: compiled from the release tarball with systemd, jemalloc and sixel image support enabled, like Debian's own build, and registered in
/etc/shells - ✅ Sid Gets the Newer of the Two: versions here end in
~griffo, so when Sid's archive has built the same tmux release, its package sorts above this one and apt picks it by itself - ✅ Automatic Updates: packages updated within hours of upstream releases
- ✅ Two Architectures: amd64 and arm64 on every suite, so the same tmux runs on servers, laptops and ARM boards like the Raspberry Pi
- ✅ Multi-Distribution: works on Bookworm, Trixie, Forky and Sid
- ✅ Easy Maintenance: standard apt commands for updates
📦 Package Build Repository
The Debian packages are automatically built and maintained in this GitHub repository:
- 🔳 tmux-debian - Latest release builds
🔗 Related Packages
Also available from deb.griffo.io:
- Zellij - A terminal workspace and multiplexer in Rust, with layouts and plugins
- workmux - git worktrees and tmux windows as isolated dev environments
- kitty - A fast, GPU based terminal emulator to run tmux in
- Neovim - The editor most often found in a tmux pane
- fish - A friendly interactive shell for every pane
💝 Support This Project
If this repository saves you time and effort, please consider supporting it!
