A secure, open-source password manager, 2FA generator, secure notes app, and file locker built with Python.
OpenVault combines strong encryption with an intuitive command-line interface to protect your sensitive data locally.
- Password Management: Store and organize passwords with custom categories
- Two-Factor Authentication: Generate TOTP codes with QR code import (image or webcam)
- Secure File Storage: Encrypt and store sensitive files locally
- Encrypted Notes: Create and manage secure text notes
- Cross-Platform: Works on Windows, macOS, and Linux
- Zero-Knowledge Architecture: All encryption and decryption happens locally
OpenVault uses modern, proven cryptographic methods:
- AES-128 (via Fernet): All vault data and files are encrypted using Fernet (AES in CBC mode with HMAC authentication)
- PBKDF2 Key Derivation: Protects the master password using a salt and many iterations
- Zero-Knowledge: No data leaves your device; no remote storage
- Clipboard Auto-Clear: Copies expire automatically after a configurable timeout
- Local Storage Only: Your data stays in your local filesystem
- Python 3.8 or higher
- pip (Python package manager)
git clone https://github.com/OR-6/OpenVault.git
cd OpenVault
pip install -r requirements.txt
python main.pyRequired packages:
cryptography— encryption and key handlingpyotp— time-based one-time password generationqrcode— QR code creation for 2FA backupsrich— styled command-line interfacepillow— image handling for QR decoding
Optional (for advanced QR scanning features):
opencv-python— webcam QR scanningpyzbar— QR code decoding
-
First Run: Launch OpenVault and set your master password:
python main.py
-
Add a Password: Password Manager → Add Password
-
Set Up 2FA: 2FA Authenticator → Add 2FA → Scan QR or enter secret
-
Store Files: Secure File Locker → Upload File
-
Create Notes: Secure Notes → Add Note
- Add, view, edit, and delete entries
- Category-based organization
- Optional password generator
- Clipboard auto-clear for sensitive fields
- Import from QR (webcam or image file)
- Manual secret key entry
- Automatic detection of algorithm, digits, and period from otpauth URIs
- Real-time code generation with expiry countdown
- Export 2FA secrets as QR for backup
- Encrypt and store any file type
- Organized by category
- Decrypt to a chosen location
- Option to open decrypted files immediately
- Create encrypted text notes
- Category organization
- View, edit, and delete notes
Vault data is stored locally:
- Linux/macOS:
~/.config/openvault/ - Windows:
%APPDATA%\openvault\
Key files:
vault.enc— Encrypted vault databaseconfig.json— App settingslocker/— Encrypted file storage
Pull requests are welcome. To contribute:
- Fork the repository
- Create a feature branch:
git checkout -b feature-name - Make changes and add tests
- Run tests:
python -m pytest - Open a pull request
Please use GitHub Issues. Include:
- Python version
- OS
- Steps to reproduce
- Expected vs. actual results
- Use a strong, unique master password
- Backup your vault file securely
- Keep your OpenVault installation up-to-date
- Consider full-disk encryption for added protection
MIT License — see LICENSE for details.
While OpenVault uses strong encryption, no software can guarantee absolute security. Use at your own risk and maintain secure backups.
OR-6
- Read the documentation
- Search issues
- Open a new issue if needed
⭐ Star this repo if you find it useful!