How fatehali-abbasali/cipherforge-encryption-tool works
CipherForge is a cross-platform desktop application for encrypting and decrypting files and folders. The main workflow runs from the GUI through the application service and workflow orchestrator to the file or folder engines; encryption can also store a recovery key locally or on removable media. Key management and persistent settings are supporting layers. The graph follows explicit source-index references and README capabilities; several backend modules were not sampled, so uncertain connections are omitted rather than inferred.
Main entry points: app_service.py Application service · workflow.py Workflow orchestrator · main_window.py Main window · key_manager.py Key management
Components 20
Desktop interface
- Main window
app/gui/main_window.py - Encryption page
app/gui/encryption_page.py - Decryption page
app/gui/decryption_page.py - Settings page
app/gui/settings_page.py
Encryption workflow
- Application service
core/app_service.py - Workflow orchestrator
core/workflow.py - File encryption
core/file_crypto.py - Folder encryption
core/folder_crypto.py - Error handling
core/app_errors.py
Cryptographic services
- Key management
core/key_manager.py - Key derivation
core/kdf.py - Cipher primitives
core/crypto.py - Crypto container
core/container.py - Crypto exceptions
core/exceptions.py
Persistence and recovery
- Recovery services
core/recovery.py - Recovery key storage
core/storage_manager.py - Removable drives
core/usb_manager.py - Settings persistence
core/config_manager.py - Secure deletion
core/secure_delete.py
Other components
- User
Connections 27
- User → Main window: uses
README.md - Main window → Encryption page: shows
app/gui/main_window.py - Main window → Decryption page: shows
app/gui/main_window.py - Main window → Settings page: shows
app/gui/main_window.py - Encryption page → Application service: requests encryption
app/gui/encryption_page.py - Decryption page → Application service: requests decryption
app/gui/decryption_page.py - Settings page → Application service: uses
app/gui/settings_page.py - Application service → Workflow orchestrator: delegates operations
core/app_service.py - Application service → File encryption: inspects containers
core/app_service.py - Application service → Folder encryption: inspects containers
core/app_service.py - Application service → Recovery key storage: manages recovery keys
core/app_service.py - Application service → Removable drives: lists drives
core/app_service.py - Application service → Settings persistence: loads settings
core/app_service.py - Application service → Error handling: normalizes errors
core/app_service.py - Workflow orchestrator → File encryption: encrypts files
core/workflow.py - Workflow orchestrator → Folder encryption: encrypts folders
core/workflow.py - Workflow orchestrator → Recovery key storage: stores recovery keys
core/workflow.py - Workflow orchestrator → Key management: manages keys
core/workflow.py - File encryption → Key management: uses key envelopes
core/file_crypto.py - Folder encryption → Key management: uses key envelopes
core/folder_crypto.py - Recovery key storage → Removable drives: detects removable media
- Crypto container → Cipher primitives: uses primitives
core/container.py - Crypto container → Crypto exceptions: raises
core/container.py - Cipher primitives → Crypto exceptions: raises
core/crypto.py - Key management → Key derivation: derives keys
- User → Recovery services: requests recovery
README.md - User → Secure deletion: requests deletion