# tpm

> Tmux Plugin Manager: installs, updates, and removes tmux plugins from GitHub or other git repositories, configured via ~/.tmux.conf.

Stars: 15.1k · Language: Shell · License: MIT · Categories: Shell

- Repository: https://github.com/tmux-plugins/tpm
- Page: https://www.trmn.sh/tools/tpm

## Install

- Git clone: `git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm`

## Overview

tpm (Tmux Plugin Manager) is a plugin manager for tmux. It clones plugins from git repositories into ~/.tmux/plugins/ and sources them when tmux loads its configuration. It requires tmux 1.9 or higher, git, and bash, and is documented as tested on Linux, OSX, and Cygwin.

Plugins are declared in ~/.tmux.conf (or $XDG_CONFIG_HOME/tmux/tmux.conf) with lines such as `set -g @plugin 'github_username/plugin_name'`. Branches can be pinned with `plugin_name#branch`, and full git URLs such as `git@github.com:user/plugin` or Bitbucket repositories are also accepted. tpm itself is initialized with `run '~/.tmux/plugins/tpm/tpm'` at the bottom of the config file.

Management happens through tmux key bindings: `prefix` + I installs new plugins and refreshes the tmux environment, `prefix` + U updates plugins, and `prefix` + alt + u removes plugins no longer listed in the config. Additional docs cover creating your own plugin, managing plugins from the command line, changing the install directory, and automating tpm installation on a new machine. The tool is aimed at tmux users who want to keep their plugins declared in their dotfiles. The README also points to tpack, a drop-in replacement with a TUI, auto-updates, and a plugin browser.

### Installation

```bash
# via Git clone
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
```

## Alternatives

- [Pure](https://www.trmn.sh/tools/pure.md): ZSH prompt that shows git branch, dirty state, and async-checked unpushed/unpulled arrows, with exit-status coloring and command execution time. (Shell, 14.5k stars)
- [Spaceship Prompt](https://www.trmn.sh/tools/spaceship-prompt.md): Customizable Zsh prompt that shows Git/Mercurial status, language runtime versions, Docker, Kubernetes, battery and more, with support for custom sections. (Shell, 20.6k stars)
- [zsh-autosuggestions](https://www.trmn.sh/tools/zsh-autosuggestions.md): Zsh plugin that shows inline command suggestions after the cursor, drawn from history and tab-completion, in the style of Fish. (Shell, 36.2k stars)
- [Powerlevel10k](https://www.trmn.sh/tools/powerlevel10k.md): Zsh prompt theme with an interactive configuration wizard, instant prompt at shell startup, Git status segments, and Powerlevel9k config compatibility. (Shell, 55.3k stars)
- [Oh My Zsh](https://www.trmn.sh/tools/ohmyzsh.md): Community-maintained framework for managing zsh configuration, with 300+ plugins, 140+ themes, and a built-in updater. (Shell, 190.2k stars)

---

Canonical: https://www.trmn.sh/tools/tpm