otplet

It provides a blocklet that shows your favourite’s site/application otp.

Installation

• Copy blocklet to blocklets directory (e.g. $HOME/.config/i3blocks/blocklets)
• Add blocklet to i3blocks config (e.g. $HOME/.config/i3blocks/config)

Here’s a sample configuration, ${BLOCKLETS_DIR} has to be set in i3 configuration or env:

[otp_blocklet]
command = ${BLOCKLETS_DIR}/otp_blocklet
interval = 1
fg_color = #ff0000
bg_color =
label = 🎄

Downloads

• linux amd64 version
• linux arm64 version

Build details

• Coverage

Folders description

internal/ contains the blocklet’s core OTP logic and runtime helper packages.

• internal/onetimepass
  • Defines PassCode, the OTP result object with code text, expiration, remaining lifetime, and error state.
  • Provides validation for generated one-time passwords.
• internal/provider
  • Implements OtpProvider, which generates and refreshes TOTP codes from a configured key.
  • Uses a background refresher and atomic code storage so the current OTP is always available.
• internal/render
  • Contains the render adapter that exposes OTP values to the bar/blocklet framework.
  • Formats short/long text, label, and colors for display.
• internal/secretmanager
  • Manages loading and saving OTP key URLs from disk.
  • Handles path expansion (~) and JSON persistence for secret storage.

License

MIT

Author

spetix

This site is open source. Improve this page.