ericonr / get-otp

Homebrewn solution for comfortably turning OTP secrets into access tokens from the command line

get-otp

This repository holds a combination of tools that can be used to (comfortably) generate TOTP 2FA access tokens on the desktop, instead of depending on a phone app.

get-otp

Main tool, depends on:

• jq
• fzf
• OATH Toolkit
• wl-clipboard (optional)

It will use the cbc-file executable from this project to decrypt a ~/.local/share/otp_accounts file, whose decrypted contents should be in the same format as exported by andOTP. It can then run a menu, using fzf, to let you choose the account for which you want an access token. If running on Wayland, the token will also be copied to the clipboard.

$ get-otp [account_name]

encrypt-otp

This tool doesn't depend on anything besides cbc-file. What it does is encrypt the file passed to it (which should be in the format exported by andOTP, as mentioned above) and put the encrypted file in the correct place.

$ encrypt-otp otp_accounts.json

cbc-file

Mostly hidden utility, does the encryption magic. Despite the name, uses ChaCha20+Poly1305 for encryption, as implemented by BearSSL, together with argon2 for key derivation.

Both of the mentioned libraries are necessary for building this utility. On Linux, a kernel which implements the getrandom(2) syscall is necessary, since it is the backend for getentropy(3), which is the only random number backend implemented.

Disclaimer

This is experimental code and ideas, and shouldn't be put anywhere near any sort of production. However, I am open to suggestions and improvements, so feel free to reach out.