pass-botp

A pass 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
• For everyone else, simply drop botp.bash into your pass extensions directory. E.g. /usr/lib/password-store/extensions/