https://github.com/hbldh/termauth
TOTP Authenticator with configurable storage of tokens
https://github.com/hbldh/termauth
authentication otpauth
Last synced: 24 days ago
JSON representation
TOTP Authenticator with configurable storage of tokens
- Host: GitHub
- URL: https://github.com/hbldh/termauth
- Owner: hbldh
- License: mit
- Created: 2017-10-11T10:28:41.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-04-23T21:43:26.000Z (6 months ago)
- Last Synced: 2025-05-30T18:06:30.594Z (5 months ago)
- Topics: authentication, otpauth
- Language: Python
- Size: 9.77 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `hbldh` Authenticator
A small wrapper around `pyotp` to provide tailored
storage of Authenticator tokens.
The tokens are intended to be stored on an encrypted partition or similar,
enabling this authenticator to be used as a backup for the mobile-based one.
It can also be used to provision a new
## Installation
```bash
$ pip install git+https://github.com/hbldh/termauth.git@master
```
## Usage
By default, `termauth` looks for a config file at `~/.hbldhauth`,
containing the path to the actual file containing the tokens to be
used for Authenticator code generation.
Sample tokens file:
```text
Github|account_name: abcdefghijklmnop
Discord|account_email: abcd efgh ijkl mnop
Sentry|account_email: ABCD EFGH IJKL MNOP QRST UVWX YZ23 4567
```
### `termauth` Usage
`termauth` is a Textual application
that provides a terminal-based user interface for
getting TOTP codes.
```powershell
termauth
```
This will show a list of all tokens in the file, and you can see the
TOTP codes for each token.
### `hbldhauth` Usage
Run `hbldhauth`:
```bash
$ hbldhauth
--- hbldh Authenticator ---
Valid for 17 seconds...
Github (account_name): 998 725
Discord (account_email): 998 725
Sentry (account_email): 362 213
```
### Display QR codes
To display a web page with all QR codes for provisioning e.g. a new phone,
run
```
$ hbldhauth --qr
--- hbldh Authenticator ---
Generating QR code page at C:\Users\henri\AppData\Local\Temp\tmpvyx1wlan.html...
Deleted QR code web page.
```