OTPCLIENT(1)

📦
version 5.1.5 · 3 versions
, in nixpkgs unstable, ubuntu stonking

💖 OTPCLIENT(1) — the OTPClient manual, but make it cute 💖

okay so bestie. welcome to the OTPClient Manual, page OTPCLIENT(1). buckle up, we're learning about one-time passwords and honestly? it's giving secure. 🔐✨

✨ NAME ✨

otpclient — a GTK4 / libadwaita client for TOTP and HOTP one-time passwords. yes she's pretty and she's functional. main character energy fr. 👑

🌸 SYNOPSIS 🌸

otpclient

that's it. that's the whole vibe. no flags, no drama, just launch her. 💅

🦋 DESCRIPTION 🦋

okay so OTPClient is a GTK4 / libadwaita application that generates Time-based (TOTP) and HMAC-based (HOTP) one-time passwords. the way that the encrypted token database just sits on disk using AES-256-GCM with an Argon2id-derived key?? obsessed. genuinely obsessed. your secrets are locked up tighter than my group chat. 🫶🔒

🎀 FEATURES 🎀

  • TOTP and HOTP support. both of them. equal respect.
  • custom digits (4-10), period (1-300 s), and algorithm (SHA1, SHA256, SHA512) — like, you can literally tune it however you want. no cap.
  • Steam-style codes. 🎮 iconic behaviour.
  • manage multiple databases and switch between them. polyamorous but for databases, lowkey.
  • per-token grouping with filterable views. everything organised, everything cute. ✨
  • 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). the way she just takes everything?? ate. 💀
  • add new tokens manually, by scanning a QR code from a file, or via the device camera. three ways to add, zero excuses. 📷
  • auto-lock after a configurable inactivity timeout, on screensaver activation, or on demand. she's protective and we love that for her.
  • optional integration with the system Secret Service for keyring-stored database passwords (also enables cross-database search). 👀 fancy.
  • optional GNOME Shell / KDE KRunner search provider that surfaces tokens in the system search results. your tokens just show up in search like they own the place. periodt.

💜 FILES 💜

  • ~/.var/app/com.github.paolostivanin.OTPClient/config/otpclient/otpclient.cfg — the Flatpak configuration file (when you're running under Flatpak, that is).
  • ~/.config/otpclient/otpclient.cfg — configuration file containing the path to the active database. this is the one telling everyone where the good stuff lives.
  • GSettings schema — com.github.paolostivanin.OTPClient stores user preferences (theme, auto-lock, notifications, KDF parameters, etc.). all your settings, safe and sound. 🌈

🧚 ENVIRONMENT 🧚

  • XDG_CONFIG_HOME — honoured by GLib for locating the configuration file. GLib checks it, respects it, moves on. a queen recognising a queen. 💖

🌟 SEE ALSO 🌟

  • otpclient-cli(1) — yeah she has a sister and her sister lives in the terminal. go say hi. 🖤

⭐ BUGS ⭐

found a bug? don't just sit there bestie, report it! 🐛 Report issues at https://github.com/paolostivanin/OTPClient/issues

that's the whole page, you're officially educated 💅 anyway love you, stay encrypted, bye! 🌸✨

this was the OTPClient Manual — page OTPClient, dated May 2026. 🎀🫶

📦 where this page comes from