NAME¶

otpclient - GTK4 / libadwaita client for TOTP and HOTP one-time passwords

SYNOPSIS¶

otpclient

DESCRIPTION¶

OTPClient is a GTK4 / libadwaita application that generates Time-based (TOTP) and HMAC-based (HOTP) one-time passwords. The encrypted token database is stored on disk using AES-256-GCM with an Argon2id-derived key.

FEATURES¶

• TOTP and HOTP support.
• Custom digits (4-10), period (1-300 s), and algorithm (SHA1, SHA256, SHA512).
• Steam-style codes.
• Manage multiple databases and switch between them.
• Per-token grouping with filterable views.
• Import and export Aegis (plain or encrypted), AuthPro (plain or encrypted), 2FAS (plain or encrypted), FreeOTP+ (plain), and Google Authenticator QR codes (file or live capture).
• Add new tokens manually, by scanning a QR code from a file, or via the device camera.
• Auto-lock after a configurable inactivity timeout, on screensaver activation, or on demand.
• Optional integration with the system Secret Service for keyring-stored database passwords (also enables cross-database search).
• Optional GNOME Shell / KDE KRunner search provider that surfaces tokens in the system search results.

FILES¶

~/.var/app/com.github.paolostivanin.OTPClient/config/otpclient/otpclient.cfg

Flatpak configuration file (when running under Flatpak).

~/.config/otpclient/otpclient.cfg

Configuration file containing the path to the active database.

GSettings schema

com.github.paolostivanin.OTPClient Stores user preferences (theme, auto-lock, notifications, KDF parameters, etc.).

ENVIRONMENT¶

XDG_CONFIG_HOME

Honoured by GLib for locating the configuration file.

SEE ALSO¶

otpclient-cli(1)

BUGS¶

Report issues at https://github.com/paolostivanin/OTPClient/issues