#command-line-tool #2fa #totp #active #clipboard #codes #authentication

yanked ova

CLI tool for managing your 2FA authentication codes written in pure Rust

1 unstable release

0.1.6 Apr 27, 2023
0.1.5 Apr 27, 2023

#27 in #2fa

MIT license

28KB
669 lines

(O)TP (VA)ULT - ova. clipboard

ova is a simple CLI tool which lets you manage your TOTPs, or basically lets you get your two-way authentication code straight to your clipboard.

  • Project is in active development state, if something's not working the way it should work, you're more than welcome to open an issue.

Available commands

Command Options Description
ova get -n, --name <name of a key>, -c, --copy <true/false> Get 2FA code for specified key, copy to clipboard determined by -c flag
ova add -n, --name <name of a key>, -k, --key <2FA secret> Store your key locally at ~/.config/ova.store or '%USERPROFILE%\AppData\Local'
ova remove -n, --name <name of a key> Remove key from local store file
ova update -n, --name <name of a key>, -k, --key <new secret value> Update key if it exists
ova list no options List all stored keys and their secrets
ova help no options Provide description for all the commands

Note that ova help could be executed per subcommand as well, like ova add help which provides a description for chosen subcommand.

Dependencies

ova depends on xclip or wl-copy to use system-wide clipboard.

  • Linux X11 - xclip should be installed
  • Linux Wayland - wl-copy should be installed

Windows & Mac OS does not require any additional setup as they use powershell 😣 and osascript respectively.

Install

You can install ova via

cargo install ova

Or use precompiled binaries provided as releases.

Currently tested with

  • Bitwarden
  • Facebook
  • Twitter

What's to do

  • Storing keys in a local file 🎉
  • Fully working get, add, list commands 🎉
  • Fully working remove and update commands 🎉
  • Copy to clipboard working on Windows, Mac OS and Linux
  • Pretty print
  • Rewrite windows copy method to winapi and throw away powershell 😣
  • More to come...

Credits

Icon by BomSymbols

Dependencies

~1.8–2.5MB
~48K SLoC