invalid or unknown command: `bind-key -t vi-copy ....`

[kevinushey]

It looks like my attempts to bind keys in my .tmux.conf with vi-copy are now failing:

/Users/kevin/.tmux.conf:25: invalid or unknown command: bind-key -t vi-copy y copy-pipe "reattach-to-user-namespace pbcopy"
/Users/kevin/.tmux.conf:26: invalid or unknown command: bind-key -t vi-copy v begin-selection
/Users/kevin/.tmux.conf:30: invalid or unknown command: bind-key -t vi-copy Y copy-end-of-line
/Users/kevin/.tmux.conf:31: invalid or unknown command: bind-key -t vi-copy V rectangle-toggle
/Users/kevin/.tmux.conf:32: invalid or unknown command: bind-key -t vi-copy Enter copy-pipe "reattach-to-user-namespace pbcopy"
/Users/kevin/.tmux.conf.2:3: invalid or unknown command: bind-key -t vi-copy PPage page-up
/Users/kevin/.tmux.conf.2:4: invalid or unknown command: bind-key -t vi-copy NPage page-down

Is this expected with current tmux?

$ tmux -V
tmux master

Thanks!

[kevinushey]

Reading the updating man pages, it looks like this is intentional, and we must now write e.g.

bind-key -t vi-copy ...        # before
bind-key -T copy-mode-vi ...   # after

Are there any plans to support the old way of declaring copy-mode keybindings?

[nicm]

No this is how it is now.

[kevinushey]

Got it; thanks.

[timotheecour]

@nicm
can this new syntax be backported to previous version of tmux? so that tmux.conf will work in either

[flowchartsman]

Conversion how-to

For anyone who finds this for posterity, the full changes should be as follows:

Steps

1. replace -t with -T
2. replace vi-<name> with <name>-mode-vi
3. prefix the command with send-keys -X

Brief Example

bind-key -t vi-copy v begin-selection

becomes

bind-key -T copy-mode-vi v send-keys -X begin-selection

Longer Example

From my own tmux.conf:

Old Way

bind-key -t vi-edit Up history-up
bind-key -t vi-edit Down history-down
unbind-key -t vi-copy Space     ;   bind-key -t vi-copy v begin-selection
unbind-key -t vi-copy Enter     ;   bind-key -t vi-copy y copy-pipe "reattach-to-user-namespace pbcopy"
unbind-key -t vi-copy C-v       ;   bind-key -t vi-copy C-v rectangle-toggle
unbind-key -t vi-copy [         ;   bind-key -t vi-copy [ begin-selection
unbind-key -t vi-copy ]         ;   bind-key -t vi-copy ] copy-selection

New Way

bind-key -T edit-mode-vi Up send-keys -X history-up
bind-key -T edit-mode-vi Down send-keys -X history-down
unbind-key -T copy-mode-vi Space     ;   bind-key -T copy-mode-vi v send-keys -X begin-selection
unbind-key -T copy-mode-vi Enter     ;   bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "reattach-to-user-namespace pbcopy"
unbind-key -T copy-mode-vi C-v       ;   bind-key -T copy-mode-vi C-v send-keys -X rectangle-toggle
unbind-key -T copy-mode-vi [         ;   bind-key -T copy-mode-vi [ send-keys -X begin-selection
unbind-key -T copy-mode-vi ]         ;   bind-key -T copy-mode-vi ] send-keys -X copy-selection