Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/the-robin-hood/ttm
Terminal TOTP Manager is a command-line tool for managing TOTPs
https://github.com/the-robin-hood/ttm
2fa authentication authenticator otp totp totp-authenticator totp-generator two-factor-authentication
Last synced: 22 days ago
JSON representation
Terminal TOTP Manager is a command-line tool for managing TOTPs
- Host: GitHub
- URL: https://github.com/the-robin-hood/ttm
- Owner: The-Robin-Hood
- License: mit
- Created: 2023-06-19T17:45:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-06-24T12:58:49.000Z (over 1 year ago)
- Last Synced: 2024-11-27T18:32:28.276Z (about 1 month ago)
- Topics: 2fa, authentication, authenticator, otp, totp, totp-authenticator, totp-generator, two-factor-authentication
- Language: Python
- Homepage: https://pypi.org/project/pyttm
- Size: 79.9 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Made for developers by a developer ♥
Terminal TOTP Manager is a command-line tool for managing Time-based One-Time Passwords (TOTPs).
It allows you to securely store and generate TOTPs for your various accounts.
## Prerequisites
- Python 3.x
## Building Standalone Executable
```shell
pyinstaller ttm.spec
```
## Installation
```shell
pip install pyttm
```
## Usage
To use TOTP Manager, follow these steps:
1. Open a terminal or command prompt and navigate to the project directory.
2. Run the following command:
```shell
ttm [command]
```
Replace `[command]` with one of the following options:
- `add`: Add a new TOTP credential.
- `list`: List all saved TOTPs
- `delete`: Delete a TOTP credential.
3. If this is your first time using TOTP Manager, you will be prompted to create a password to secure your credentials. The password must be at least 8 characters long.
4. Depending on the command you choose:
- For `add`: You can enter the OTPauth URI directly or provide the required information manually.
- For `list`: The Issuer and their associated TOTPs will be displayed continuously.
- For `delete`: Select the issuer of the credential you want to delete from the displayed list.
## Security
- The TOTP Manager stores your credentials securely by hashing the password before storing it in a DB file (`config.db`) at `ttm` folder `%APPDATA%` or `XDG_CONFIG_HOME` depending on OS.
- You can only access the TOTP Manager by providing the correct password.
## Contributing
Contributions are welcome! If you encounter any issues or have suggestions for improvements, please report them on the project's GitHub page.
## License
The Project is released under the [MIT License](https://opensource.org/licenses/MIT). Please refer to the LICENSE file for more details.