https://github.com/Alkindi42/tmux-bitwarden

Access your Bitwarden login items within tmux
https://github.com/Alkindi42/tmux-bitwarden

Last synced: 3 months ago
JSON representation

Access your Bitwarden login items within tmux

• Host: GitHub
• URL: https://github.com/Alkindi42/tmux-bitwarden
• Owner: Alkindi42
• Created: 2020-10-13T20:18:54.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2023-12-07T23:36:25.000Z (11 months ago)
• Last Synced: 2024-04-18T16:02:00.269Z (7 months ago)
• Language: Shell
• Size: 4.88 KB
• Stars: 32
• Watchers: 1
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-tmux - tmux-bitwarden

README

        
# 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 [email protected]

? 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 ``, 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`