table of contents
- Tumbleweed 5.3.2-1.1
- Leap-16.0
| 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-minimized
- 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.
- 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¶
BUGS¶
Report issues at https://github.com/paolostivanin/OTPClient/issues
| October 2026 | otpclient |