Yayo

A command line interface (CLI) used to manage and generate OTP (one time password) codes for your various accounts.

Installation

Install using [cargo]:

shell cargo install yayo

Pre-compiled Binaries

An alternative method is to download and run the pre-compiled binaries:

https://github.com/nickjer/yayo/releases

Usage

Check the help (--help) for details on using this tool:

```shell yayo 0.1.0 Jeremy Nicklas jeremywnicklas@gmail.com A CLI used to manage and generate OTP (one time password) codes for your accounts

USAGE: yayo

FLAGS: -h, --help Prints help information -V, --version Prints version information

SUBCOMMANDS: add Add a new account delete Delete an account help Prints this message or the help of the given subcommand(s) list List all accounts view View the code for an account ```

Add Account

The add subcommand is used to add an account:

```shell yayo-add Add a new account

USAGE: yayo add [OPTIONS]

ARGS: Name of the account Secret key used to generate code

FLAGS: -h, --help Prints help information -V, --version Prints version information

OPTIONS: -a, --algorithm Algorithm used to generate code [env: YAYOALGORITHM=] [default: SHA1] [possible values: SHA1, SHA256, SHA512] -d, --digits Number of digits composing code [env: YAYODIGITS=] [default: 6] -s, --step Duration in seconds of step [env: YAYO_STEP=] [default: 30] ```

Note: For added security it stores all secrets in your operating system's local keyring.

Example: Add your GitHub account with provided secret (XXXXXXX):

console $ yayo add github XXXXXXX

Although it is not recommended, you can alter any of the arguments used in the OTP code generation (algorithm, digits, and step) as command line options or through environment variables.

Delete Account

The delete subcommand is used to delete a previously added account:

```shell yayo-delete Delete an account

USAGE: yayo delete

ARGS: Name of the account

FLAGS: -h, --help Prints help information -V, --version Prints version information ```

Example: Delete the previously added GitHub account:

console $ yayo delete github

List All Accounts

The list subcommand is used to list all available accounts and their provided configurations:

```shell yayo-list List all accounts

USAGE: yayo list

FLAGS: -h, --help Prints help information -V, --version Prints version information ```

View Account

The view subcommand is used to output the OTP code generated for the requested account:

```shell yayo-view View the code for an account

USAGE: yayo view

ARGS: Name of the account

FLAGS: -h, --help Prints help information -V, --version Prints version information ```

Example: View the OTP for the GitHub account:

console $ yayo view github 389200

Linux (Gnome) - Keyboard Shortcut to Clipboard

This is a simple walkthough on setting up the F12 key to populate the clipboard with the OTP code. This makes logging into GitHub or any other service as simple as pushing F12 and pasting the contents of the clipboard into the 2FA input.

1. You will need xsel or some other CLI that can read the contents of STDOUT to the clipboard:

   console $ sudo apt install -y xsel

2. If using Gnome 3 you can just open the control center and navigate to the "Keyboard Shortcuts" with:

   console $ gnome-control-center

3. Scroll to the bottom and set a "Custom" keyboard shortcut with the following options:

   Name: OTP (GitHub)
   Command: bash -c 'yayo view github | xsel --input --primary'
   Shortcut: F12