mirror of
https://github.com/fscotto/infra.git
synced 2026-05-30 23:49:56 +00:00
Restrict tmux and desktop tools to Void hosts
This commit is contained in:
57
dotfiles/desktop/.tmux/plugins/tmux-bitwarden/README.md
Normal file
57
dotfiles/desktop/.tmux/plugins/tmux-bitwarden/README.md
Normal file
@@ -0,0 +1,57 @@
|
||||
# tmux-bitwarden
|
||||
|
||||
## Requirements
|
||||
You need to have:
|
||||
* [Bitwarden CLI](https://bitwarden.com/)
|
||||
* [jq](https://stedolan.github.io/jq/)
|
||||
* [fzf](https://github.com/junegunn/fzf)
|
||||
* bash > 4.0
|
||||
|
||||
## Install
|
||||
|
||||
### Tmux Plugin Manager (recommended)
|
||||
1. In your `.tmux.conf` add the plugin to the list.
|
||||
```
|
||||
set -g @plugin 'Alkindi42/tmux-bitwarden'
|
||||
```
|
||||
2. Type `prefix + I` to install the plugin.
|
||||
|
||||
## Key bindings
|
||||
* `prefix + b`: list login items in a bottom pane.
|
||||
|
||||
## Usage
|
||||
First, log into your Bitwarden user account using the `login` command (you only need to do this once):
|
||||
```bash
|
||||
$ bw login your-email@domain.com
|
||||
? Master password: [input is hidden]
|
||||
To unlock your vault, set your session key to the `BW_SESSION` environment variable. ex:
|
||||
$ export BW_SESSION="lpvf7Rt+pAMXW2YJ5O42jJp6ZY0Ny01vq9jaUdFYbroS1CXWgjVdy7j42owHVoLwZf+yDI+ro68Qngo9mdD/vA=="
|
||||
> $env:BW_SESSION="lpvf7Rt+pAMXW2YJ5O42jJp6ZY0Ny01vq9jaUdFYbroS1CXWgjVdy7j42owHVoLwZf+yDI+ro68Qngo9mdD/vA=="
|
||||
```
|
||||
|
||||
In a tmux session, you can run the plugin with the default key binding `prefix + b`. This opens a new pane at the bottom with login items. You can choose your login item with `<Enter>`, your password will be automatically filled.
|
||||
|
||||
If you have not configured your bitwarden session (`BW_SESSION`), you will be prompted to re-enter your master password before each selection (see configuration section for more information)
|
||||
|
||||
## Configuration
|
||||
|
||||
### Changing the default key-binding
|
||||
```
|
||||
set -g @bw-key 'T'
|
||||
```
|
||||
Default: `u`
|
||||
|
||||
### Define Bitwarden session
|
||||
To avoid re-entering your master password before each selection, you can define your [session Bitwarden](https://bitwarden.com/help/article/cli/#session-management).
|
||||
Your `BW_SESSION` comes from the result of the `login` command.
|
||||
```
|
||||
set -g @bw-session 'BW_SESSION'
|
||||
```
|
||||
If the `BW_SESSION` variable exists in your environment variable then it will be used.
|
||||
|
||||
### Copy the password to the clipboard
|
||||
By default, after selection, the password is sent in the last pane. If you want to have it in your clipboard you have to activate the option:
|
||||
```
|
||||
set -g @bw-copy-to-clipboard 'on'
|
||||
```
|
||||
Default: `off`
|
||||
Reference in New Issue
Block a user