Metadata-Version: 2.4
Name: hackauth
Version: 0.1.4
Summary: A polished CLI/TUI authenticator and TOTP manager
Project-URL: Homepage, https://github.com/wenfeng110402/Authenticator
Project-URL: Bug Tracker, https://github.com/wenfeng110402/Authenticator/issues
Author-email: Wenfeng Ye <wenfeng110402@icloud.com>
License: GPLv3
License-File: LICENSE
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: click
Requires-Dist: opencv-python
Requires-Dist: opencv-python-headless; platform_system != 'Windows'
Requires-Dist: pyotp
Requires-Dist: pyperclip
Requires-Dist: qrcode
Requires-Dist: questionary
Requires-Dist: rich
Requires-Dist: textual==7.5.0
Description-Content-Type: text/markdown

# Authenticator

```text
  ______               __      __                                                  __                         
 /      \             /  |    /  |                                                /  |                        
/$$$$$$  | __    __  _$$ |_   $$ |____    ______   _______    _______   ______   _$$ |_     ______    ______  
$$ |__$$ |/  |  /  |/ $$   |  $$      \  /      \ /       \  /       | /      \ / $$   |   /      \  /      \ 
$$    $$ |$$ |  $$ |$$$$$$/   $$$$$$$  |/$$$$$$  |$$$$$$$  |/$$$$$$$/  $$$$$$  |$$$$$$/   /$$$$$$  |/$$$$$$  |
$$$$$$$$ |$$ |  $$ |  $$ | __ $$ |  $$ |$$    $$ |$$ |  $$ |$$ |       /    $$ |  $$ | __ $$ |  $$ |$$ |  $$/ 
$$ |  $$ |$$ \__$$ |  $$ |/  |$$ |  $$ |$$$$$$$$/ $$ |  $$ |$$ \_____ /$$$$$$$ |  $$ |/  |$$ \__$$ |$$ |      
$$ |  $$ |$$    $$/   $$  $$/ $$ |  $$ |$$       |$$ |  $$ |$$       |$$    $$ |  $$  $$/ $$    $$/ $$ |      
$$/   $$/  $$$$$$/     $$$$/  $$/   $$/  $$$$$$$/ $$/   $$/  $$$$$$$/  $$$$$$$/    $$$$/   $$$$$$/  $$/       
```

A simple, polished CLI for managing and viewing TOTP (one-time password) codes.

## Features

- Store and manage TOTP secrets (add / rename / delete / list)
- View live, continuously updating TOTP codes
- Textual-based dashboard for a modern terminal UI

## Requirements

- Python 3.9+

## Installation

Run `pip install hackauth`

Another way from the project root:

- Create and activate an environment (example uses a local .conda):

  - `conda create -p .conda python=3.11 -y`
  - `conda activate .conda`
- Install dependencies and register the CLI:

  - `pip install -e .`

## Usage

Show version:

`auth version`

Generate a TOTP code from a secret (replace with your own secret):

`auth now JBSWY3DPEHPK3PXP`

Manage stored secrets (add/rename/delete/list):

`auth settings`

Open the live dashboard:

`auth panel`

Show your stored keys:

`auth output`

Optionally, export in different formats:

`auth output --format json`
`auth output --format plain`
