3.1 KiB
Help, tpm not working!
Here's the list of issues users had with tpm
:
Nothing works.
tpm
key bindingsprefix + I
,prefix + U
not even defined.
Related issue #22
-
Do you have required
tmux
version to runtpm
?
Checktmux
version with$ tmux -V
command and make sure it's higher or equal to the required version fortpm
as stated in the readme. -
ZSH tmux plugin might be causing issues.
If you have it installed, try disabling it and see iftpm
works then. -
Are you using
tmux
as a top level shell?
Iftmux
is the top level shell (not started from another shell) then the environment during initialisation could be very minimal. For example, if yourtmux
binary is under/usr/local/bin
(as it is in macOS when installed with Homebrew) thentpm
will not find it since/usr/local/bin
might not be in the$PATH
. A workaround would be to extend the$PATH
manually in.tmux.conf
before loadingtpm
:set-environment -g "PATH" "/usr/local/bin:$PATH"
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
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:
-
remove all
set -g @plugin
lines from tmux config file -
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'
-
Reload TMUX environment so TPM is sourced:
$ tmux source /path/to/my_tmux.conf
The plugins should now be working.
Weird sequence of characters show up when installing or updating plugins
Related: issue #25
- This could be caused by tmuxline.vim plugin. Uninstall it and see if things work.
"failed to connect to server" error when sourcing .tmux.conf
Related: issue #48
- Make sure
tmux source ~/.tmux.conf
command is ran from insidetmux
.
tpm not working: '~/.tmux/plugins/tpm/tpm' returned 2 (Windows / Cygwin)
Related: issue #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):
find ~/.tmux -type d -name '.git*' -prune -o -type f -print0 | xargs -0 dos2unix