https://github.com/msmol/pass-botp

A pass extension for managing TOTP Backup Codes
https://github.com/msmol/pass-botp

2fa mfa otpauth password-store totp

Last synced: 2 days ago
JSON representation

A pass extension for managing TOTP Backup Codes

• Host: GitHub
• URL: https://github.com/msmol/pass-botp
• Owner: msmol
• Created: 2017-08-09T20:31:55.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-08-10T15:32:03.000Z (over 7 years ago)
• Last Synced: 2024-08-03T02:02:52.912Z (3 months ago)
• Topics: 2fa, mfa, otpauth, password-store, totp
• Language: Shell
• Size: 2.93 KB
• Stars: 7
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-password-store - pass-botp

README

        
# pass-botp

A [pass](https://www.passwordstore.org/) extension for managing TOTP Backup Codes

## Usage

```

$ pass botp

Usage: pass botp [--clip,-c] pass-name

```

## Example

`pass-botp` assumes your backup codes are stored line by line.

The first line of your file *must* be `# pass-botp`. Without this header `pass-botp` will refuse to give you a backup code and will not modify the file.

E.g. `backup_codes.gpg`:

```

# pass-botp

111 111

222 222

333 333

444 444

...

```

`pass-botp` will provide you with the first non-commented line, and then comment that line out:

```

$ pass botp backup_codes

111 111

```

`backup_codes.gpg` will now be:

```

# pass-botp

# 111 111

222 222

333 333

444 444

...

```

On each subsequent run, `pass-botp` will give the next available backup code (in this case, `222 222`) until none remain.

## Copying to clipboard

Simply add `-c` or `--clip`

```

$ pass botp -c backup_codes

Copied Backup code for backup_codes to clipboard. Will clear in $PASSWORD_STORE_CLIP_TIME seconds.

```

## Install

- For Arch Linux users there is a package available in the [AUR](https://aur.archlinux.org/packages/pass-botp/)

- For everyone else, simply drop `botp.bash` into your pass extensions directory. E.g. `/usr/lib/password-store/extensions/`