OTPCLIENT(1)

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