rafi / tmux-pass

Quick password-store browser with preview using fzf in tmux.

tmux-pass

Quick password-store browser with preview using fzf in tmux.

Install

Requirements

• password-store
• tmux 2.1+ (2.2 recommended)
• bash 4+
• fzf

Using Tmux Plugin Manager

Add the following to your list of TPM plugins in ~/.tmux.conf:

set -g @plugin 'rafi/tmux-pass'

Hit prefix + I to fetch and source the plugin. You should now be able to use the plugin!

Manual

Clone the repo:

git clone https://github.com/rafi/tmux-pass ~/.tmux/plugins/tmux-pass

Source it in your ~/.tmux.conf:

run-shell ~/.tmux/plugins/tmux-pass/tmux-pass.tmux

Reload tmux config by running:

tmux source-file ~/.tmux.conf

Configuration

NOTE: for changes to take effect, you'll need to source again your ~/.tmux.conf file.

• @pass-key
• @pass-copy-to-clipboard
• @pass-window-size
• @pass-hide-pw-from-preview
• @pass-hide-preview

@pass-key

default: B

Customize how to display the pass browser. Always preceded by prefix: prefix + @pass-key

For example:

set -g @pass-key b

@pass-copy-to-clipboard

default: on

Copies selected password into clipboard.

For example:

set -g @pass-copy-to-clipboard on

@pass-window-size

default: 10

The size of the tmux split that will be opened.

For example:

set -g @pass-window-size 10

@pass-hide-pw-from-preview

default: off

Show only additional information in the preview pane (e.g. login, url, etc.), but hide the password itself.
This can be desirable in situations when you don't want bystanding people to get a glimpse at your passwords.

For example:

set -g @pass-hide-pw-from-preview 'on'

@pass-hide-preview

default: off

Start with the preview pane hidden.

For example:

set -g @pass-hide-preview

Acknowledgements

This plugin is inspired by tmux-1password.

License

MIT