A terminal authenticator. It shows the current TOTP code for each of your accounts and a bar counting down to the next rotation, refreshed every second.
go run .Or build a binary with go build -o totp . and run ./totp.
With no config the app shows demo accounts so you can see how it looks. Point it at your own accounts as described below.
The app reads accounts from the first file it finds. It checks the path in
$TOTP_FILE, then accounts.txt in the working directory. If neither exists it
looks under your user config directory.
Each line is either an otpauth:// URI or a pipe-separated shorthand, and lines
that start with # are ignored.
otpauth://totp/Example:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=Example
Example Corp|bob|GEZDGNBVGY3TQOJQGEZA
JBSWY3DPEHPK3PXP
Your secrets are the keys to your accounts. Keep the accounts file readable only
by you, and do not commit it anywhere. This repository ignores accounts.txt so
it cannot be added by accident, and generated codes never leave your machine.
Move the selection with the up and down arrows. Press q to quit.
This software comes with no warranty, as stated in the license, and it has not been independently audited. You are responsible for keeping your secrets safe and for keeping backup recovery codes in case you lose access to this tool.
Licensed under the MIT License (see LICENSE). Contributions are welcome; see CONTRIBUTING.md.
If you use this project, please cite it. A machine-readable CITATION.cff is included; expand below for a BibTeX entry.
BibTeX
@software{Vulpes_totp_2026,
author = {Vulpes, Aesthetic},
title = {totp},
year = {2026},
month = jul,
version = {0.1.0},
url = {https://github.com/tui-apps/totp}
}Part of the tui-apps collection
Six small, single-purpose terminal apps.
| App | What it does |
|---|---|
| calc | live calculator |
| algebra-visual | function grapher |
| classical-ciphers | cipher encoder and decoder |
| crypto-charts | crypto price charts |
| totp | TOTP authenticator (this repo) |
| life | Conway's Game of Life |