Add .tmux/plugins/tpm/CHANGELOG.md

Add .tmux/plugins/tpm/HOW_TO_PLUGIN.md
Add .tmux/plugins/tpm/LICENSE.md
Add .tmux/plugins/tpm/README.md
Add .tmux/plugins/tpm/bin/clean_plugins
Add .tmux/plugins/tpm/bin/install_plugins
Add .tmux/plugins/tpm/bin/update_plugins
Add .tmux/plugins/tpm/bindings/clean_plugins
Add .tmux/plugins/tpm/bindings/install_plugins
Add .tmux/plugins/tpm/bindings/update_plugins
Add .tmux/plugins/tpm/docs/automatic_tpm_installation.md
Add .tmux/plugins/tpm/docs/changing_plugins_install_dir.md
Add .tmux/plugins/tpm/docs/how_to_create_plugin.md
Add .tmux/plugins/tpm/docs/managing_plugins_via_cmd_line.md
Add .tmux/plugins/tpm/docs/tpm_not_working.md
Add .tmux/plugins/tpm/.git/HEAD
Add .tmux/plugins/tpm/.git/config
Add .tmux/plugins/tpm/.git/description
Add .tmux/plugins/tpm/.git/hooks/applypatch-msg.sample
Add .tmux/plugins/tpm/.git/hooks/commit-msg.sample
Add .tmux/plugins/tpm/.git/hooks/fsmonitor-watchman.sample
Add .tmux/plugins/tpm/.git/hooks/post-update.sample
Add .tmux/plugins/tpm/.git/hooks/pre-applypatch.sample
Add .tmux/plugins/tpm/.git/hooks/pre-commit.sample
Add .tmux/plugins/tpm/.git/hooks/pre-merge-commit.sample
Add .tmux/plugins/tpm/.git/hooks/pre-push.sample
Add .tmux/plugins/tpm/.git/hooks/pre-rebase.sample
Add .tmux/plugins/tpm/.git/hooks/pre-receive.sample
Add .tmux/plugins/tpm/.git/hooks/prepare-commit-msg.sample
Add .tmux/plugins/tpm/.git/hooks/push-to-checkout.sample
Add .tmux/plugins/tpm/.git/hooks/sendemail-validate.sample
Add .tmux/plugins/tpm/.git/hooks/update.sample
Add .tmux/plugins/tpm/.git/index
Add .tmux/plugins/tpm/.git/info/exclude
Add .tmux/plugins/tpm/.git/logs/HEAD
Add .tmux/plugins/tpm/.git/logs/refs/heads/master
Add .tmux/plugins/tpm/.git/logs/refs/remotes/origin/HEAD
Add .tmux/plugins/tpm/.git/objects/info/.keep
Add .tmux/plugins/tpm/.git/objects/pack/pack-1f8e91c4b0c2fd3de85deb1de59db344d5af0319.idx
Add .tmux/plugins/tpm/.git/objects/pack/pack-1f8e91c4b0c2fd3de85deb1de59db344d5af0319.pack
Add .tmux/plugins/tpm/.git/objects/pack/pack-1f8e91c4b0c2fd3de85deb1de59db344d5af0319.rev
Add .tmux/plugins/tpm/.git/packed-refs
Add .tmux/plugins/tpm/.git/refs/heads/master
Add .tmux/plugins/tpm/.git/refs/remotes/origin/HEAD
Add .tmux/plugins/tpm/.git/refs/tags/.keep
Add .tmux/plugins/tpm/.gitattributes
Add .tmux/plugins/tpm/.gitignore
Add .tmux/plugins/tpm/.gitmodules
Add .tmux/plugins/tpm/.travis.yml
Add .tmux/plugins/tpm/tpm
Add .tmux/plugins/tpm/lib/tmux-test/.keep
Add .tmux/plugins/tpm/scripts/check_tmux_version.sh
Add .tmux/plugins/tpm/scripts/clean_plugins.sh
Add .tmux/plugins/tpm/scripts/install_plugins.sh
Add .tmux/plugins/tpm/scripts/source_plugins.sh
Add .tmux/plugins/tpm/scripts/update_plugin.sh
Add .tmux/plugins/tpm/scripts/update_plugin_prompt_handler.sh
Add .tmux/plugins/tpm/scripts/helpers/plugin_functions.sh
Add .tmux/plugins/tpm/scripts/helpers/shell_echo_functions.sh
Add .tmux/plugins/tpm/scripts/helpers/tmux_echo_functions.sh
Add .tmux/plugins/tpm/scripts/helpers/tmux_utils.sh
Add .tmux/plugins/tpm/scripts/helpers/utility.sh
Add .tmux/plugins/tpm/scripts/variables.sh
Add .tmux/plugins/tpm/tests/expect_failed_plugin_download
Add .tmux/plugins/tpm/tests/expect_successful_clean_plugins
Add .tmux/plugins/tpm/tests/expect_successful_multiple_plugins_download
Add .tmux/plugins/tpm/tests/expect_successful_plugin_download
Add .tmux/plugins/tpm/tests/expect_successful_update_of_a_single_plugin
Add .tmux/plugins/tpm/tests/expect_successful_update_of_all_plugins
Add .tmux/plugins/tpm/tests/test_plugin_clean.sh
Add .tmux/plugins/tpm/tests/test_plugin_installation.sh
Add .tmux/plugins/tpm/tests/test_plugin_installation_legacy.sh
Add .tmux/plugins/tpm/tests/test_plugin_sourcing.sh
Add .tmux/plugins/tpm/tests/test_plugin_update.sh
Add .tmux/plugins/tpm/tests/helpers/tpm.sh
This commit is contained in:
Lewis Wynne 2025-11-01 23:54:16 +00:00
parent 507a5b456d
commit 6e896e6d8e
75 changed files with 3042 additions and 0 deletions

View file

@ -0,0 +1,102 @@
# Help, tpm not working!
Here's the list of issues users had with `tpm`:
<hr />
> Nothing works. `tpm` key bindings `prefix + I`, `prefix + U` not even
defined.
Related [issue #22](https://github.com/tmux-plugins/tpm/issues/22)
- Do you have required `tmux` version to run `tpm`?<br/>
Check `tmux` version with `$ tmux -V` command and make sure it's higher or
equal to the required version for `tpm` as stated in the readme.
- ZSH tmux plugin might be causing issues.<br/>
If you have it installed, try disabling it and see if `tpm` works then.
<hr />
> Help, I'm using custom config file with `tmux -f /path/to/my_tmux.conf`
to start Tmux and for some reason plugins aren't loaded!?
Related [issue #57](https://github.com/tmux-plugins/tpm/issues/57)
`tpm` has a known issue when using custom config file with `-f` option.
The solution is to use alternative plugin definition syntax. Here are the steps
to make it work:
1. remove all `set -g @plugin` lines from tmux config file
2. in the config file define the plugins in the following way:
# List of plugins
set -g @tpm_plugins ' \
tmux-plugins/tpm \
tmux-plugins/tmux-sensible \
tmux-plugins/tmux-resurrect \
'
# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
run '~/.tmux/plugins/tpm/tpm'
3. Reload TMUX environment so TPM is sourced: `$ tmux source /path/to/my_tmux.conf`
The plugins should now be working.
<hr />
> Weird sequence of characters show up when installing or updating plugins
Related: [issue #25](https://github.com/tmux-plugins/tpm/issues/25)
- This could be caused by [tmuxline.vim](https://github.com/edkolev/tmuxline.vim)
plugin. Uninstall it and see if things work.
<hr />
> "failed to connect to server" error when sourcing .tmux.conf
Related: [issue #48](https://github.com/tmux-plugins/tpm/issues/48)
- Make sure `tmux source ~/.tmux.conf` command is ran from inside `tmux`.
<hr />
> tpm not working: '~/.tmux/plugins/tpm/tpm' returned 2 (Windows / Cygwin)
Related: [issue #81](https://github.com/tmux-plugins/tpm/issues/81)
This issue is most likely caused by Windows line endings. For example, if you
have git's `core.autocrlf` option set to `true`, git will automatically convert
all the files to Windows line endings which might cause a problem.
The solution is to convert all line ending to Unix newline characters. This
command handles that for all files under `.tmux/` dir (skips `.git`
subdirectories):
```bash
find ~/.tmux -type d -name '.git*' -prune -o -type f -print0 | xargs -0 dos2unix
```
<hr />
> '~/.tmux/plugins/tpm/tpm' returned 127 (on macOS, w/ tmux installed using brew)
Related: [issue #67](https://github.com/tmux-plugins/tpm/issues/67)
This problem is because tmux's `run-shell` command runs a shell which doesn't read from user configs, thus tmux installed in a brew prefix (e.g. `/usr/local/bin`) will not be found.
The solution is to find your brew prefix
```sh
> echo "$(brew --prefix)/bin"
/opt/homebrew/bin
```
And prepend it to the `PATH` environment variable
```
set-environment -g PATH "/opt/homebrew/bin:/bin:/usr/bin"
```
before any `run-shell`/`run` commands in `~/.tmux.conf`.