authenticator-tui 1.0.0__tar.gz

authenticator_tui-1.0.0/.gitignore

@@ -0,0 +1,5 @@
+otp.txt
+__pycache__/
+*.pyc
+.gitlab-ci-local/
+reports/

authenticator_tui-1.0.0/.gitlab-ci.yml

@@ -0,0 +1,35 @@
+variables:
+  TRIVY_SERVER: "https://trivy.lab.gronlier.fr"
+  UV_PYTHON_DOWNLOADS: never # prevent uv from fetching a newer Python version
+  UV_NO_SYNC: "1"
+  PYTHON_REPOSITORY_USERNAME: pypi-oidc
+
+include:
+  - component: $CI_SERVER_FQDN/to-be-continuous/semantic-release/gitlab-ci-semrel@4
+    inputs:
+      commit-spec: conventionalcommits
+  - component: $CI_SERVER_FQDN/to-be-continuous/python/gitlab-ci-python@9
+    inputs:
+      image: python:3.13-alpine
+      pytest-enabled: true
+      ruff-enabled: true
+      ruff-args: "--fix"
+      mypy-enabled: true
+      pyright-enabled: true
+      publish-enabled: true
+
+semantic-release:
+  allow_failure: true
+
+py-publish:
+  variables:
+    PYTHON_PUBLISH_TOOL: twine
+    PYTHON_REPOSITORY_USERNAME: pypi-oidc
+    PYTHON_REPOSITORY_URL: "https://upload.pypi.org/legacy/"
+  before_script:
+    - !reference [.python-base, before_script]
+    - apk add --no-cache git # versioningit extension
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+#      aud: "$PYPI_OIDC_AUD"

authenticator_tui-1.0.0/.python-version

@@ -0,0 +1 @@
+3.13

authenticator_tui-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pierre Gronlier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

authenticator_tui-1.0.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: authenticator-tui
+Version: 1.0.0
+Summary: A keyboard-driven terminal UI for managing TOTP/HOTP one-time passwords
+Project-URL: Homepage, https://gitlab.com/riphixel/authenticator-tui
+Project-URL: Repository, https://gitlab.com/riphixel/authenticator-tui
+Project-URL: Issues, https://gitlab.com/riphixel/authenticator-tui/-/issues
+Author-email: Pierre Gronlier <pierre@gronlier.fr>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: 2fa,authenticator,hotp,mfa,otp,terminal,textual,totp,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.13
+Requires-Dist: pyotp>=2.10.0
+Requires-Dist: pyperclip>=1.11.0
+Requires-Dist: textual>=8.2.7
+Description-Content-Type: text/markdown
+
+# authenticator-tui
+
+A terminal UI for managing TOTP/HOTP one-time passwords stored as `otpauth://` URLs.
+
+<img width="700" src="screenshots/main.svg" alt="Main screen">
+
+## Features
+
+- **Live codes** — TOTP codes refresh every second with a countdown progress bar
+- **Filter** — press `f` and type to narrow the list by issuer or account
+- **Add** — paste an `otpauth://` URL or fill in fields manually
+- **Delete** — remove an entry with auto-save
+- **Big code view** — press Enter on any entry to display the code in large digits
+- **Clipboard** — click any entry to copy the code
+- **Export** — write all entries to a file as `otpauth://` URLs
+
+## Install
+
+```bash
+uv tool install git+https://gitlab.com/riphixel/authenticator-tui
+```
+
+Or run directly without installing:
+
+```bash
+uvx --from git+https://gitlab.com/riphixel/authenticator-tui authenticator-tui otp.txt
+```
+
+## Usage
+
+```bash
+authenticator-tui [path/to/otp.txt]
+```
+
+If no file is given (or the path doesn't exist) a file picker appears on startup.
+The file is auto-saved on every add or delete.
+
+## Keybindings
+
+| Key | Action |
+|---|---|
+| `f` | Focus filter input |
+| `↓` in filter | Jump to first list entry |
+| `↑` on first entry | Jump back to filter |
+| `a` | Add OTP (modal) |
+| `d` | Delete selected OTP |
+| `e` | Export to file (modal) |
+| Enter | Show code in big digits |
+| Click | Copy code to clipboard |
+| Escape | Clear filter / close modal |
+| `q` | Quit |
+
+## Screenshots
+
+### Filter
+
+<img width="700" src="screenshots/filter.svg" alt="Filter">
+
+### Add OTP
+
+<img width="700" src="screenshots/add_modal.svg" alt="Add OTP modal">
+
+### Big code view
+
+<img width="700" src="screenshots/big_code.svg" alt="Big code">
+
+## File format
+
+One `otpauth://` URL per line. Blank lines and lines starting with `#` are ignored.
+
+```
+otpauth://totp/GitHub:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub
+otpauth://totp/PayPal:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=PayPal
+```
+
+## Development
+
+```bash
+uv sync
+uv run authenticator-tui otp.txt
+
+# tests
+uv run pytest
+
+# lint
+uvx ruff check .
+uvx ruff format --check .
+```

authenticator_tui-1.0.0/README.md

@@ -0,0 +1,88 @@
+# authenticator-tui
+
+A terminal UI for managing TOTP/HOTP one-time passwords stored as `otpauth://` URLs.
+
+<img width="700" src="screenshots/main.svg" alt="Main screen">
+
+## Features
+
+- **Live codes** — TOTP codes refresh every second with a countdown progress bar
+- **Filter** — press `f` and type to narrow the list by issuer or account
+- **Add** — paste an `otpauth://` URL or fill in fields manually
+- **Delete** — remove an entry with auto-save
+- **Big code view** — press Enter on any entry to display the code in large digits
+- **Clipboard** — click any entry to copy the code
+- **Export** — write all entries to a file as `otpauth://` URLs
+
+## Install
+
+```bash
+uv tool install git+https://gitlab.com/riphixel/authenticator-tui
+```
+
+Or run directly without installing:
+
+```bash
+uvx --from git+https://gitlab.com/riphixel/authenticator-tui authenticator-tui otp.txt
+```
+
+## Usage
+
+```bash
+authenticator-tui [path/to/otp.txt]
+```
+
+If no file is given (or the path doesn't exist) a file picker appears on startup.
+The file is auto-saved on every add or delete.
+
+## Keybindings
+
+| Key | Action |
+|---|---|
+| `f` | Focus filter input |
+| `↓` in filter | Jump to first list entry |
+| `↑` on first entry | Jump back to filter |
+| `a` | Add OTP (modal) |
+| `d` | Delete selected OTP |
+| `e` | Export to file (modal) |
+| Enter | Show code in big digits |
+| Click | Copy code to clipboard |
+| Escape | Clear filter / close modal |
+| `q` | Quit |
+
+## Screenshots
+
+### Filter
+
+<img width="700" src="screenshots/filter.svg" alt="Filter">
+
+### Add OTP
+
+<img width="700" src="screenshots/add_modal.svg" alt="Add OTP modal">
+
+### Big code view
+
+<img width="700" src="screenshots/big_code.svg" alt="Big code">
+
+## File format
+
+One `otpauth://` URL per line. Blank lines and lines starting with `#` are ignored.
+
+```
+otpauth://totp/GitHub:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub
+otpauth://totp/PayPal:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=PayPal
+```
+
+## Development
+
+```bash
+uv sync
+uv run authenticator-tui otp.txt
+
+# tests
+uv run pytest
+
+# lint
+uvx ruff check .
+uvx ruff format --check .
+```

authenticator_tui-1.0.0/features.md

@@ -0,0 +1,100 @@
+# authenticator-tui — Features
+
+TUI application to manage TOTP/HOTP one-time passwords stored as `otpauth://` URLs.
+
+**Run:** `uv run authenticator-tui [path/to/otp.txt]`
+
+---
+
+## File loading
+
+- Accepts a file path as a CLI argument; loads immediately if the file exists
+- Without a CLI argument (or if the path does not exist), shows a **file picker modal** on startup with the path pre-filled to `otp.txt` if that file exists in the current directory
+- Validates `otpauth://` URL format on load; reports errors via notification
+
+## OTP display
+
+- Lists all entries as scrollable rows: `Issuer / Account   XXX XXX   ████████░░  18s`
+- Codes split in the middle with a space for readability (e.g. `482 391`)
+- **Live countdown progress bar** (`█`/`░` blocks, 10 chars wide) updated every second
+- Remaining seconds shown next to the bar
+- Codes refresh automatically when a new TOTP period begins
+
+## Filtering
+
+- Filter bar always visible at the top of the screen; focused automatically on startup
+- Press **`f`** to refocus the filter input at any time
+- Matches against both **issuer** and **account** fields (case-insensitive)
+- Press **`↓`** in the filter to jump focus to the first list entry
+- Press **`↑`** on the first list entry to return focus to the filter input
+- Press **Escape** while the filter is focused to clear it and return focus to the list
+
+## Add OTP (`a`)
+
+Opens a modal with two tabs:
+
+- **Paste URL** — paste a full `otpauth://totp/...` or `otpauth://hotp/...` URL; validates on submit
+- **Manual** — form fields: Issuer, Account, Secret (required), Algorithm (SHA1 / SHA256 / SHA512), Digits (6 / 8), Period (seconds)
+- Validates the secret by attempting code generation before accepting
+- New entry is appended to the list and **auto-saved** to the source file
+
+## Delete OTP (`d`)
+
+- Deletes the currently highlighted entry from the list
+- **Auto-saves** the updated list to the source file immediately
+
+## Export (`e`)
+
+- Opens a modal pre-filled with the current file path
+- Writes all entries as `otpauth://` URLs (one per line) to the specified path
+- Atomic write (writes to `.tmp` then renames) to avoid data loss
+
+## Big code view (Enter)
+
+- Press **Enter** on any list entry to open a full-screen modal showing the code in large LED-style digits (Textual `Digits` widget)
+- Includes issuer/account label and a 30-block countdown progress bar
+- Refreshes every second; dismiss with any key or click
+
+## Clipboard copy
+
+- **Click** any entry to copy the current code (without the middle space) to the clipboard via `pyperclip`
+- Shows a brief notification confirming the copied code
+
+## OTP format support
+
+- **TOTP** (`otpauth://totp/`) — time-based, configurable period (default 30s)
+- **HOTP** (`otpauth://hotp/`) — counter-based
+- Algorithms: SHA1 (default), SHA256, SHA512
+- Code length: 6 digits (default) or 8 digits
+- URL encoding preserved as `%XX` (not `+`) on save
+
+## Keybindings
+
+| Key | Action |
+|---|---|
+| `a` | Add OTP (modal) |
+| `d` | Delete highlighted OTP |
+| `e` | Export to file (modal) |
+| `f` | Focus filter input |
+| `↓` in filter | Jump to first list entry |
+| `↑` on first entry | Jump to filter input |
+| Enter | Show code in big digits (modal) |
+| Escape (filter focused) | Clear filter, return focus to list |
+| Escape (list focused) | Quit app |
+| Escape (modal open) | Close modal |
+| `q` | Quit |
+| Click | Copy code to clipboard |
+| Up / Down | Navigate list |
+
+## Tests
+
+Headless pytest suite using Textual's `run_test()` / `Pilot` API:
+
+- File loading, filter narrowing, Escape restore
+- Filter↔list keyboard navigation (`↓` / `↑`)
+- Add modal open/cancel
+- Delete with and without selection, file persistence
+- Big code modal open/dismiss
+- Escape context-aware: exits app from list, focuses list from filter, closes export modal
+
+Run with: `uv run pytest`

authenticator_tui-1.0.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "authenticator-tui"
+dynamic = ["version"]
+description = "A keyboard-driven terminal UI for managing TOTP/HOTP one-time passwords"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Pierre Gronlier", email = "pierre@gronlier.fr" }
+]
+keywords = ["otp", "totp", "hotp", "2fa", "mfa", "authenticator", "tui", "terminal", "textual"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Environment :: Console :: Curses",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security",
+    "Topic :: Terminals",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "pyotp>=2.10.0",
+    "pyperclip>=1.11.0",
+    "textual>=8.2.7",
+]
+
+[project.urls]
+Homepage = "https://gitlab.com/riphixel/authenticator-tui"
+Repository = "https://gitlab.com/riphixel/authenticator-tui"
+Issues = "https://gitlab.com/riphixel/authenticator-tui/-/issues"
+
+[project.scripts]
+authenticator-tui = "authenticator_tui.__main__:main"
+
+[build-system]
+requires = ["hatchling", "versioningit"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "versioningit"
+default-version = "0.0.0-dev"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "textual-dev>=1.8.0",
+    "types-pyperclip>=1.11.0",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"