How tahir-1907/keyra works
Keyra is an offline Linux desktop password manager. The user opens or creates a vault, unlocks it with a master password or recovery key, then manages encrypted entries and their organization; the desktop interface also exposes history, trash, audit, generation, backup, transfer, and settings workflows. The core separates vault/key lifecycle, entry and metadata handling, repositories, SQLite storage, and service operations. Edges reflect excerpts, SOURCE INDEX references, or README statements; unsampled implementations and wiring are represented conservatively.
Main entry points: vault.py Vault lifecycle · main_window.py Application window · backup.py Encrypted backups · entries.py Entry service
Components 29
Desktop interface
- Application window
app/ui/main_window.py - Vault pages
app/ui/pages/vault.py - Entry list
app/ui/entry_list.py - Dialogs
app/ui/dialogs.py - UI components
app/ui/components.py - Settings page
app/ui/pages/settings.py - Backup page
app/ui/pages/backups.py - Transfer dialogs
app/ui/transfer_dialogs.py
Vault security
- Vault lifecycle
app/core/vault.py - Cryptographic primitives
app/core/crypto.py - Session locking
app/core/session.py - Recovery keys
app/core/recovery.py
Vault data
- Entry service
app/core/entries.py - Encrypted metadata
app/core/metadata.py - Categories and tags
app/core/categories.py - Built-in categories
app/core/builtin_categories.py - Security audit
app/core/audit.py - Password generator
app/core/generator.py
Persistence
- SQLite vault
app/database/database.py - Data repositories
app/database/repositories.py
Vault services
- Encrypted backups
app/services/backup.py - Import and export
app/services/import_export.py - PDF export
app/services/pdf_export.py - Vault migration
app/services/migration_v4.py - Upgrade workflow
app/services/vault_upgrade.py - Application settings
app/services/settings.py - Local data paths
app/utils/paths.py - Localization
app/i18n/__init__.py
Other components
- Desktop user
Connections 48
- Desktop user → Application window: uses
- Application window → Vault lifecycle: opens vault
app/ui/main_window.py - Application window → Session locking: manages session
app/ui/main_window.py - Application window → Encrypted backups: requests backups
app/ui/main_window.py - Application window → Upgrade workflow: starts upgrade
app/ui/main_window.py - Application window → Application settings: loads settings
app/ui/main_window.py - Application window → Vault pages: hosts pages
app/ui/main_window.py - Vault pages → Entry service: manages entries
app/ui/pages/vault.py - Vault pages → Entry list: uses list
app/ui/pages/vault.py - Vault pages → Dialogs: opens dialogs
app/ui/pages/vault.py - Entry list → UI components: renders with
app/ui/entry_list.py - Settings page → Application settings: updates settings
app/ui/pages/settings.py - Settings page → UI components: renders with
app/ui/pages/settings.py - Backup page → Encrypted backups: manages backups
app/ui/pages/backups.py - Backup page → Transfer dialogs: opens transfer
app/ui/pages/backups.py - Transfer dialogs → Import and export: transfers data
app/ui/transfer_dialogs.py - Transfer dialogs → Encrypted backups: handles backup files
app/ui/transfer_dialogs.py - Transfer dialogs → PDF export: exports PDF
app/ui/transfer_dialogs.py - Vault lifecycle → Cryptographic primitives: wraps data key
app/core/vault.py - Vault lifecycle → SQLite vault: opens vault file
app/core/vault.py - Vault lifecycle → Data repositories: reads vault metadata
app/core/vault.py - Vault lifecycle → Recovery keys: uses recovery
app/core/vault.py - Vault lifecycle → Encrypted metadata: creates metadata store
app/core/vault.py - Entry service → Cryptographic primitives: encrypts fields
app/core/entries.py - Entry service → Encrypted metadata: uses metadata
app/core/entries.py - Entry service → Data repositories: stores encrypted data
app/core/entries.py - Categories and tags → Built-in categories: uses built-ins
app/core/categories.py - Categories and tags → Entry service: validates references
app/core/categories.py - Categories and tags → Data repositories: accesses categories
app/core/categories.py - Encrypted metadata → Cryptographic primitives: derives subkeys
app/core/metadata.py - Data repositories → SQLite vault: queries SQLite
app/database/repositories.py - Encrypted backups → Vault lifecycle: backs up vault
app/services/backup.py - Encrypted backups → Cryptographic primitives: encrypts backup
app/services/backup.py - Encrypted backups → Data repositories: reads vault metadata
app/services/backup.py - Import and export → Entry service: imports entries
app/services/import_export.py - Import and export → Categories and tags: imports categories
app/services/import_export.py - Import and export → Vault lifecycle: uses vault
app/services/import_export.py - Upgrade workflow → Vault migration: runs migration
app/services/vault_upgrade.py - Upgrade workflow → Encrypted backups: creates backup
app/services/vault_upgrade.py - Upgrade workflow → Vault lifecycle: opens vault
app/services/vault_upgrade.py - Application settings → Local data paths: resolves local paths
app/services/settings.py - Application settings → Session locking: configures locking
app/services/settings.py - Application window → Localization: sets interface language
app/ui/main_window.py - Desktop user → Security audit: runs audit
- Desktop user → Password generator: generates passwords
- Desktop user → Settings page: configures app
- Desktop user → Backup page: manages backups
- Desktop user → Transfer dialogs: imports or exports