{"id":49073377,"url":"https://github.com/tim-projects/aegis-tui","last_synced_at":"2026-04-20T08:30:52.878Z","repository":{"id":325008119,"uuid":"1096924527","full_name":"tim-projects/aegis-tui","owner":"tim-projects","description":"An interactive ncurses tui app for viewing one-time passwords generated from Aegis Authenticator backups","archived":false,"fork":false,"pushed_at":"2026-02-26T09:57:20.000Z","size":374,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-26T10:31:23.484Z","etag":null,"topics":["2fa-client","aegis","totp-authenticator","totp-cli","totp-codes","totp-generator","totp-tokens"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tim-projects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-15T07:37:01.000Z","updated_at":"2026-01-18T08:50:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tim-projects/aegis-tui","commit_stats":null,"previous_names":["tim-projects/aegis-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tim-projects/aegis-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Faegis-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Faegis-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Faegis-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Faegis-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tim-projects","download_url":"https://codeload.github.com/tim-projects/aegis-tui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Faegis-tui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32039864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["2fa-client","aegis","totp-authenticator","totp-cli","totp-codes","totp-generator","totp-tokens"],"created_at":"2026-04-20T08:30:47.573Z","updated_at":"2026-04-20T08:30:52.856Z","avatar_url":"https://github.com/tim-projects.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aegis-tui\n\nAn unofficial interactive command-line interface for viewing Aegis Authenticator Time-based One-Time Passwords (TOTP).\n\n**Note:** This tool is primarily a viewer and does not support editing or creating new OTP codes. For that use the official app here: https://getaegis.app/\n\n### Example Output\n\nWhen run without a group filter, OTP codes are obscured by default. Other entries are dimmed, and the selected entry is highlighted with a dark blue background in search mode:\n\n```text\n--- All OTPs ---\n#   Issuer             Name               Code    Group              Note\n--- ---                ----               ----    -----              ----\n1   Bank of America    MyBank             123456  Finance            Checking Account\n2   Facebook           MySocial           ******  Social             Personal Profile\n3   Google             MyEmail            ******  Personal           Primary Email\n4   Steam              MyGaming           ******  Gaming             Steam Account\n\nType to filter, use arrows to select, Enter to reveal (Ctrl+C to exit): \nTime until next refresh: 25.0 seconds\n```\n\nWhen filtering by a specific group (e.g., `aegis-tui /path/to/your/aegis-backup.json --group Finance`) or by pressing g in interactive mode:\n\n```text\n--- All OTPs ---\n#   Issuer             Name               Code    Group              Note\n--- ---                ----               ----    -----              ----\n1   Bank of America    MyBank             123456  Finance            Checking Account\n\nTime until next refresh: 25.0 seconds\n```\n\n## Features\n\n- Decrypts Aegis Authenticator vault files using a provided password\n- Continuously displays OTP codes in a real-time refreshing table\n- Interactive mode with type-to-search and arrow key navigation\n- Automatically reveals the code if only one OTP entry is displayed\n- Filter by group name interactively or via command line\n- Respects terminal dimensions to prevent output overflow\n- Option to copy codes directly to clipboard (configure in `~/.config/aegis-tui/config.json`)\n- Scriptable via `--json` output mode for automation\n\n## Installation (Arch Linux AUR)\n\nTo install `aegis-tui` on Arch Linux, you can use an AUR helper like `yay` or `paru`:\n\n```bash\nyay -S aegis-tui\n# or\nparu -S aegis-tui\n```\n\nAlternatively, you can build it manually:\n\n```bash\ngit clone https://aur.archlinux.org/aegis-tui.git\ncd aegis-tui\nmakepkg -si\n```\n\n## Usage\n\nOnce installed, you can run `aegis-tui` from any terminal with the path to your Aegis vault `.json` file:\n\n```bash\naegis-tui /path/to/your/aegis-backup.json\n```\n\nIf no vault path is provided, `aegis-tui` will first attempt to open the last used vault file stored in its configuration. If no last used vault is found, it will then automatically search for the most recently modified `aegis-backup-*.json` file in the current directory, and then in `~/.config/aegis`.\n\nIf your vault requires a password, you will be prompted securely. For non-interactive use (e.g., in scripts), you can provide the password via the `AEGIS_CLI_PASSWORD` environment variable:\n\n```bash\nexport AEGIS_CLI_PASSWORD=\"YourVaultPassword\"\naegis-tui /path/to/your/aegis-backup.json --no-color\n```\n\n### Command Line Options\n\n- `-g, --group` - Filter OTP entries by a specific group name\n- `--json` - Output in JSON format (useful for scripting)\n- `--no-color` - Disable colored output\n- `-u, --uuid` - Display OTP for a specific entry UUID\n\n## Configuration\n\n`aegis-tui` stores its configuration in `~/.config/aegis-tui/config.json`. This file is automatically created if it doesn't exist. It stores the path to the last successfully opened Aegis vault file and the `default_color_mode` setting.\n\nExample `config.json`:\n\n```json\n{\n    \"last_opened_vault\": \"/home/user/.config/aegis-tui/aegis-backup-20251026-200544.json\",\n    \"last_vault_dir\": \"/home/user/.config/aegis-tui\",\n    \"default_color_mode\": true\n}\n```\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0. See the `LICENSE` file for details.\n\nThis project is a complete rewrite in Python, originally inspired by the `avdu` project (https://github.com/Sammy-T/avdu). It provides CLI functionality for displaying OTP codes from an encrypted Aegis vault.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-projects%2Faegis-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftim-projects%2Faegis-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-projects%2Faegis-tui/lists"}