Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rafi/tmux-pass
Quick password-store browser with preview using fzf in tmux.
https://github.com/rafi/tmux-pass
bash fzf password-store tmux
Last synced: about 2 months ago
JSON representation
Quick password-store browser with preview using fzf in tmux.
- Host: GitHub
- URL: https://github.com/rafi/tmux-pass
- Owner: rafi
- Created: 2018-11-06T18:57:23.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-07-31T18:14:26.000Z (about 2 months ago)
- Last Synced: 2024-07-31T21:40:10.602Z (about 2 months ago)
- Topics: bash, fzf, password-store, tmux
- Language: Shell
- Size: 10.7 KB
- Stars: 18
- Watchers: 4
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-password-store - tmux-pass - store browser with preview using fzf in tmux. (Interfaces / All other extensions)
README
# tmux-pass [](https://travis-ci.org/rafi/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](https://www.passwordstore.org)
* [tmux](https://github.com/tmux/tmux/wiki) 3.x+
* bash 4+
* [fzf](https://github.com/junegunn/fzf)
### Using [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm)
Add the following to your list of TPM plugins in `~/.tmux.conf`:
```bash
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:
```bash
git clone https://github.com/rafi/tmux-pass ~/.tmux/plugins/tmux-pass
```
Source it in your `~/.tmux.conf`:
```bash
run-shell ~/.tmux/plugins/tmux-pass/plugin.tmux
```
Reload tmux config by running:
```bash
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-key)
* [@pass-copy-to-clipboard](#pass-copy-to-clipboard)
* [@pass-window-size](#pass-window-size)
* [@pass-hide-pw-from-preview](#pass-hide-pw-from-preview)
* [@pass-hide-preview](#pass-hide-preview)
### @pass-key
```
default: B
```
Customize how to display the pass browser.
Always preceded by prefix: prefix + @pass-key
For example:
```bash
set -g @pass-key b
```
### @pass-copy-to-clipboard
```
default: on
```
Copies selected password into clipboard.
For example:
```bash
set -g @pass-copy-to-clipboard on
```
### @pass-window-size
```
default: 10
```
The size of the tmux split that will be opened.
For example:
```bash
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:
```bash
set -g @pass-hide-pw-from-preview 'on'
```
### @pass-hide-preview
```
default: off
```
Start with the preview pane hidden.
For example:
```bash
set -g @pass-hide-preview
```
## Acknowledgements
This plugin is inspired by [tmux-1password](https://github.com/yardnsm/tmux-1password).
## License
MIT