oathtool

.. image:: https://img.shields.io/pypi/v/oathtool.svg :target: https://pypi.org/project/oathtool

.. image:: https://img.shields.io/pypi/pyversions/oathtool.svg

.. image:: https://github.com/jaraco/oathtool/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/oathtool/actions?query=workflow%3A%22tests%22 :alt: tests

.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff

.. .. image:: https://readthedocs.org/projects/PROJECT_RTD/badge/?version=latest .. :target: https://PROJECT_RTD.readthedocs.io/en/latest/?badge=latest

.. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton

TOTP code generator based on oathtool.

Usage

Command-line::

$ python -m oathtool $key

API::

>>> oathtool.generate_otp(key)

Create standalone script (Unix)::

$ python -m oathtool.generate-script
$ ./oathtool $key

Don't want to install oathtool, but just want the script? Use pip-run <https://pypi.org/project/pip-run>_::

$ pip-run oathtool -- -m oathtool.generate-script
$ ./oathtool $key

generate-script also takes an arbitrary target path in case you wish to generate the script elsewhere::

$ python -m oathtool.generate-script ~/bin/my-oathtool

Or install with pipx <https://pipxproject.github.io/pipx/>_::

$ pipx install oathtool
$ oathtool $key