# otp-authenticator

Simple tool for keeping track of your one-time pad two-factor authentication
keys; basically a command-line version of the canonical [Google Authenticator
App][gauth].

[gauth]: https://github.com/google/google-authenticator

The library uses GnuPG (through *h-gpgme*) to safely encrypt your secret keys.
The first time you use it, it asks for a fingerprint to use for encryption.
Currently *GnuPG 1.x* has some issues with *h-gpgme* when asking for keys, so
*GPG 2.x* is recommended.  Keys are stored, encrypted, at `~/.otp-auth.vault`
by default.

Instructions are available through `--help`, but the basics are:

```bash
# interactively add a new key
otp-auth add

# interactively add a new key by entering the secret key uri
#   (following the otpauth protocol)
otp-auth add --uri

# view all time-based codes and cached counter-based codes
otp-auth view

# list accounts, do not display codes
otp-auth view --list

# generate a new counter-based code
otp-auth gen ID

# edit the metadata and delete codes
otp-auth edit ID
otp-auth delete ID

# dump all stored data as json (and as yaml)
otp-auth dump
otp-auth dump --yaml
```

You can edit configuration at `~/.otp-auth.yaml`, the basic schema is:

```yaml
fingerprint: ABCDEF12
vault: /home/robert/.otp-auth.vault
```