Simple Python TOTP code generator that stores TOTP secrets in your keyring.
Install with pip install totp-generator
As of version 3 this requires python 3.7+. Version 2.x is tested to run on python 2.7 - 3.8, however this major version will not receive any updates.
Supported keyrings can be found here. You can also
specify the keyring settings in a config
file. Run totp_generator with the -d flag for the config root path and the current keyring service.
setproctitle is an optional dependency due permission and dependency requirements on some systems. Install with
pip install totp-generator[proctitle] to install this dependancy and enable setting the process name. This feature
is useful for some uses with some keyrings such as the OSX Keychain.
Run totp_generator with the --help flag for more information.
This project uses semantic versioning (major.minor.patch).
Install the test requirements with pip install ".[test]" . Run the tests with pytest (see https://github.com/jjfalling/TOTP-Generator/blob/master/.github/workflows/python-tests.yml for command).
To create a new build:
- Bump the version in totp_generator/__init__.py
- Run
python setup.py upload - Add a new Github release with the git tag that setup.py created (same as the new version number).