{"id":13395684,"url":"https://github.com/tmux-plugins/tpm","last_synced_at":"2025-05-13T15:11:14.357Z","repository":{"id":17168646,"uuid":"19935788","full_name":"tmux-plugins/tpm","owner":"tmux-plugins","description":"Tmux Plugin Manager","archived":false,"fork":false,"pushed_at":"2024-08-05T08:25:43.000Z","size":212,"stargazers_count":12964,"open_issues_count":147,"forks_count":450,"subscribers_count":86,"default_branch":"master","last_synced_at":"2025-04-23T18:56:42.108Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmux-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-05-19T09:18:38.000Z","updated_at":"2025-04-23T18:28:35.000Z","dependencies_parsed_at":"2023-02-10T17:30:21.921Z","dependency_job_id":"b906f57f-ba4c-4f85-80e5-3367f39b1789","html_url":"https://github.com/tmux-plugins/tpm","commit_stats":{"total_commits":187,"total_committers":31,"mean_commits":6.032258064516129,"dds":"0.28342245989304815","last_synced_commit":"99469c4a9b1ccf77fade25842dc7bafbc8ce9946"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftpm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftpm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftpm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmux-plugins%2Ftpm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmux-plugins","download_url":"https://codeload.github.com/tmux-plugins/tpm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969259,"owners_count":21992263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T18:00:28.012Z","updated_at":"2025-05-13T15:11:09.341Z","avatar_url":"https://github.com/tmux-plugins.png","language":"Shell","funding_links":[],"categories":["Set up tmux","Shell","HarmonyOS","CLI","Tools","Plugins","Terminal Multiplexers"],"sub_categories":["Tmux Plugins","Windows Manager","Command line"],"readme":"# Tmux Plugin Manager\n\n[![Build Status](https://travis-ci.org/tmux-plugins/tpm.svg?branch=master)](https://travis-ci.org/tmux-plugins/tpm)\n\nInstalls and loads `tmux` plugins.\n\nTested and working on Linux, OSX, and Cygwin.\n\nSee list of plugins [here](https://github.com/tmux-plugins/list).\n\n### Installation\n\nRequirements: `tmux` version 1.9 (or higher), `git`, `bash`.\n\nClone TPM:\n\n```bash\ngit clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm\n```\n\nPut this at the bottom of `~/.tmux.conf` (`$XDG_CONFIG_HOME/tmux/tmux.conf`\nworks too):\n\n```bash\n# List of plugins\nset -g @plugin 'tmux-plugins/tpm'\nset -g @plugin 'tmux-plugins/tmux-sensible'\n\n# Other examples:\n# set -g @plugin 'github_username/plugin_name'\n# set -g @plugin 'github_username/plugin_name#branch'\n# set -g @plugin 'git@github.com:user/plugin'\n# set -g @plugin 'git@bitbucket.com:user/plugin'\n\n# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)\nrun '~/.tmux/plugins/tpm/tpm'\n```\n\nReload TMUX environment so TPM is sourced:\n\n```bash\n# type this in terminal if tmux is already running\ntmux source ~/.tmux.conf\n```\n\nThat's it!\n\n### Installing plugins\n\n1. Add new plugin to `~/.tmux.conf` with `set -g @plugin '...'`\n2. Press `prefix` + \u003ckbd\u003eI\u003c/kbd\u003e (capital i, as in **I**nstall) to fetch the plugin.\n\nYou're good to go! The plugin was cloned to `~/.tmux/plugins/` dir and sourced.\n\n### Uninstalling plugins\n\n1. Remove (or comment out) plugin from the list.\n2. Press `prefix` + \u003ckbd\u003ealt\u003c/kbd\u003e + \u003ckbd\u003eu\u003c/kbd\u003e (lowercase u as in **u**ninstall) to remove the plugin.\n\nAll the plugins are installed to `~/.tmux/plugins/` so alternatively you can\nfind plugin directory there and remove it.\n\n### Key bindings\n\n`prefix` + \u003ckbd\u003eI\u003c/kbd\u003e\n- Installs new plugins from GitHub or any other git repository\n- Refreshes TMUX environment\n\n`prefix` + \u003ckbd\u003eU\u003c/kbd\u003e\n- updates plugin(s)\n\n`prefix` + \u003ckbd\u003ealt\u003c/kbd\u003e + \u003ckbd\u003eu\u003c/kbd\u003e\n- remove/uninstall plugins not on the plugin list\n\n### Docs\n\n- [Help, tpm not working](docs/tpm_not_working.md) - problem solutions\n\nMore advanced features and instructions, regular users probably do not need\nthis:\n\n- [How to create a plugin](docs/how_to_create_plugin.md). It's easy.\n- [Managing plugins via the command line](docs/managing_plugins_via_cmd_line.md)\n- [Changing plugins install dir](docs/changing_plugins_install_dir.md)\n- [Automatic TPM installation on a new machine](docs/automatic_tpm_installation.md)\n\n### Tests\n\nTests for this project run on [Travis CI](https://travis-ci.org/tmux-plugins/tpm).\n\nWhen run locally, [vagrant](https://www.vagrantup.com/) is required.\nRun tests with:\n\n```bash\n# within project directory\n./run_tests\n```\n\n### License\n\n[MIT](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmux-plugins%2Ftpm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmux-plugins%2Ftpm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmux-plugins%2Ftpm/lists"}