# twoken: generate One-Time-Passwords from stored token secrets
A command line application to generate One-Time-Passwords from token secrets stored in an external password store, like the Unix [`pass`](https://www.passwordstore.org). twoken enables two-factor authentication when a mobile device or dedicated hardware token is unavailable or impractical.
**WARNING** While secrets are stored securely in a password store, using twoken may be less secure than traditional two-factor authentication using dedicated hardware.
## Installation
```sh
cargo install twoken
```
## Usage
Create a new token and store it in the password store:
```sh
twoken --new tokens/my-soft-key
```
Generate a One-Time-Password (will copy to the clipboard):
```sh
twoken tokens/my-soft-key
```
Generate a One-Time-Password and print it:
```sh
twoken --print tokens/my-soft-key
```