authenticator-tui 1.0.0

A keyboard-driven terminal UI for managing TOTP/HOTP one-time passwords

authenticator-tui

A terminal UI for managing TOTP/HOTP one-time passwords stored as otpauth:// URLs.

Features

• Live codes — TOTP codes refresh every second with a countdown progress bar
• Filter — press f and type to narrow the list by issuer or account
• Add — paste an otpauth:// URL or fill in fields manually
• Delete — remove an entry with auto-save
• Big code view — press Enter on any entry to display the code in large digits
• Clipboard — click any entry to copy the code
• Export — write all entries to a file as otpauth:// URLs

Install

uv tool install git+https://gitlab.com/riphixel/authenticator-tui

Or run directly without installing:

uvx --from git+https://gitlab.com/riphixel/authenticator-tui authenticator-tui otp.txt

Usage

authenticator-tui [path/to/otp.txt]

If no file is given (or the path doesn't exist) a file picker appears on startup. The file is auto-saved on every add or delete.

Keybindings

Key	Action
f	Focus filter input
↓ in filter	Jump to first list entry
↑ on first entry	Jump back to filter
a	Add OTP (modal)
d	Delete selected OTP
e	Export to file (modal)
Enter	Show code in big digits
Click	Copy code to clipboard
Escape	Clear filter / close modal
q	Quit

Screenshots

Filter

Add OTP

Big code view

File format

One otpauth:// URL per line. Blank lines and lines starting with # are ignored.

otpauth://totp/GitHub:[e-mail]?secret=JBSWY3DPEHPK3PXP&issuer=GitHub
otpauth://totp/PayPal:[e-mail]?secret=JBSWY3DPEHPK3PXP&issuer=PayPal

Development

uv sync
uv run authenticator-tui otp.txt

# tests
uv run pytest

# lint
uvx ruff check .
uvx ruff format --check .