Scroll to navigation

OTPCLIENT(1) OTPClient Manual OTPCLIENT(1)

NAME

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

SYNOPSIS

otpclient [--start-minimized]

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.

OPTIONS

Start with the window hidden in the system tray instead of shown. The database is left locked, so the first time the window is shown it asks for the password. This affects the current launch only and does not change the start-minimized preference. It is ignored, with the window shown normally, when minimize-to-tray is off or no system tray was detected. --start-minimised is accepted as a spelling alias.

FEATURES

  • TOTP and HOTP support.
  • Custom digits (4-10), period (1-120 s), and algorithm (SHA1, SHA256, SHA512).
  • Steam-style codes.
  • Manage multiple databases and switch between them.
  • Per-token grouping with filterable views, and group-wide rename and removal.
  • Select several tokens to assign a group, export or delete them; a bulk delete can be undone.
  • Tokens that fail validation are kept aside and can be repaired or deleted from a review dialog.
  • 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). An import lists its tokens first, with exact duplicates unchecked, so only the ones you keep are added.
  • 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.

TOKEN ACTIONS

Single-click and arrow keys select a token without generating or copying a code. Each row carries a button in the Action column, copy for TOTP and generate for HOTP, and the same action heads the row's right-click menu. Enter and Ctrl+C activate the selected token while the token list has focus. Enter also activates a search result. HOTP counters are saved before the code is shown or copied. HOTP results from another database open that database first.

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.
~/.config/autostart/com.github.paolostivanin.OTPClient.desktop
Written when Start at Login is enabled in Settings -> Integration. Under Flatpak the same file is written on the host by org.freedesktop.portal.Background, which not every desktop implements; the setting is greyed out where it does not.
com.github.paolostivanin.OTPClient Stores user preferences (theme, auto-lock, notifications, KDF parameters, etc.).

ENVIRONMENT

Honoured by GLib for locating the configuration file.

SEE ALSO

otpclient-cli(1)

BUGS

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

October 2026 otpclient