trotp 0.1.1

TUI TOTP generator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

# TROTP

A CLI tool for managing TOTP accounts.
All accounts are stored in a local file that's encrypted with the provided password.
If you don't provide the -p argument it will expect the password on stdin.

Running `trotp` without any arguments will run the TUI interface.

[![Lint and Test](https://github.com/Krakaw/TOTP/actions/workflows/test.yml/badge.svg)](https://github.com/Krakaw/TOTP/actions/workflows/test.yml)

![](demo/demo.gif)

## Installation

```bash
cargo install trotp
```
## Usage

```bash
trotp --help
```

```
trotp 0.1.1
Krakaw <41575888+Krakaw@users.noreply.github.com>
A CLI and TUI TOTP manager

USAGE:
    totp [OPTIONS] [SUBCOMMAND]

OPTIONS:
    -f, --filename <FILENAME>    The storage filename [default: .storage.txt]
    -h, --help                   Print help information
    -p, --password <PASSWORD>    The encryption password
    -V, --version                Print version information

SUBCOMMANDS:
    add            Add a new account
    check          Check an OTP
    delete         Delete an account
    dump           Dump the config file
    generate       Generate an OTP
    help           Print this message or the help of the given subcommand(s)
    interactive    Run in interactive mode [default]
    serve          Start an HTTP Server
```

### Add accounts

    tortp -p password add -a AccountName -s SecretToken

### Delete an account

    trotp -p password delete -a AccountName

### Check an OTP against a secret for a specific time within a range

    trotp -p password check -t TokenSecretKey -o 123456 -s 2022-06-03T08:35:00+02:00 -r 10  

### Start an HTTP REST server that will return an OTP from your accounts if a name is provided or generate one for a provided secret

    trotp -p password serve

    # Example using a secret for a once off TOTP
    curl localhost:8080/JBSWY3DPEHPK3PXP
    {"account_name":"Secret","code":"359962","expiry":11}

    curl localhost:8080/acc
    {"account_name":"Account 1","code":"783196","expiry":30}

## Key Bindings

### User Interface

#### Global Key Bindings
| Key Binding | Action                  |
|-------------|-------------------------|
| `/`         | Switch to insert mode   |
| `Esc`       | Switch to normal mode   |
| `Ctrl-c`    | Exit                    |
| `Down`      | Select next account     |
| `Up`        | Select previous account |
| `Enter`     | Copy OTP to clipboard   |