authenticator-tui

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

Features

A fast, keyboard-driven terminal client for TOTP/HOTP codes — live-refreshing codes, filtering, add/delete/export, a big-code view, and clipboard copy.

See features.md for the full feature list, file discovery behavior, and keybindings.

Install

Install as a global CLI tool from PyPI:

uv tool install authenticator-tui

Or with pip:

pip install --user authenticator-tui

Or run directly without installing:

uvx authenticator-tui otp.txt

To install the latest development version from source instead:

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

Usage

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

If no file is given, it looks for otp.txt in the current directory, then ~/.config/authenticator-tui/otp.txt (created automatically if neither exists), then shows a file picker to confirm. The file is auto-saved on every add or delete. See features.md for details and the full keybindings list.

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:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub
otpauth://totp/PayPal:alice@example.com?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 .