TOTP-CLIP

Generate TOTP authentication code for 2FA from a configuration stored in a YAML file with secrets in the system keyring and copy it to the clipboard.

Configuration (YAML)

Defaults to ~/totp.yml.

service_name:
  remote_name: identifier used to look up the secret in the keyring
  window_title: title of the window showing the OTP
  store_clipboard: Boolean option to either store the OTP in the clipboard

Secret storage (keyring)

Secrets are stored in the OS-native keyring (e.g. Secret Service on Linux, Keychain on macOS, Credential Locker on Windows) via the keyring library, under the service name totp-clip.

Adding a new account

totp-clip-setup service_name

This interactively prompts for the remote name, window title, clipboard preference and the TOTP secret key provided during the setup of the two-factor authentication, then writes the entry to the YAML configuration and stores the secret in the keyring. It can also be used to overwrite an existing entry.

Alternatively, the configuration and the secret can be managed manually: add an entry to the YAML configuration as described above, then store the secret with the keyring command line tool (install it with pipx install keyring):

keyring set totp-clip remote_name

where remote_name matches the corresponding entry in the YAML configuration.

Installation

pipx install totp-clip

Usage

totp-clip service_name

A shortcut may be manually created to launch the command mentioned.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.10.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for albertop from gravatar.com albertop

Credits

Author: Alberto P

License expression

MPL-2.0
View SPDX License List

Requires

Python >=3.11

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

totp_clip-0.10.2.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

totp_clip-0.10.2-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file totp_clip-0.10.2.tar.gz.

File metadata

  • Download URL: totp_clip-0.10.2.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for totp_clip-0.10.2.tar.gz
Algorithm Hash digest
SHA256 86e404a369b142b6b4178ab7a294f3fb13b32a207a12fc69c010b643c7abce3a
MD5 9c7865c8a6be5cc9c02a585797d9126e
BLAKE2b-256 cce5604ad188f3f067421348f4780ebf64afc3adfa0202ec8a3230bb9f41da52

See more details on using hashes here.

Provenance

The following attestation bundles were made for totp_clip-0.10.2.tar.gz:

Publisher: pypi.yml on alberto743/totp-clip

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file totp_clip-0.10.2-py3-none-any.whl.

File metadata

  • Download URL: totp_clip-0.10.2-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for totp_clip-0.10.2-py3-none-any.whl
Algorithm Hash digest
SHA256 03efb8cc7579aa003f1ecfd366e65c9ccf4222a5677b4fb16a96d82c54a4de41
MD5 68d8ce587e8279b7f040d2afa785b323
BLAKE2b-256 f3a9c5a6b780bd62a7ac2315d341c300be62b5d7304316e69bb5f2ec90b31b9c

See more details on using hashes here.

Provenance

The following attestation bundles were made for totp_clip-0.10.2-py3-none-any.whl:

Publisher: pypi.yml on alberto743/totp-clip

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page