tmux-pass

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

Features

• Browse your password-store using fzf
• Preview password in a tmux split (optional)
• Detects pbcopy (macOS), xclip or xsel (Linux)
• Copy password (Enter)
• Copy username (Alt-Enter)
• OTP support (Alt-Space)
• Edit (Ctrl-e) and Delete (Ctrl-d)
• Toggle password preview (Tab)

Install

Requirements

• password-store
• tmux 3.x+
• 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/plugin.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-enable-spinner

@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: off

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 15

@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 bystanders 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 on

@pass-enable-spinner

default: on

Show a spinner when fetching items and reading entry.

To disable spinner:

set -g @pass-enable-spinner off

Acknowledgements

This plugin is inspired by tmux-1password.

License

GNU General Public License v3.0