Skip to content
OR-6Public

About

A secure, offline-first password manager, 2FA authenticator, secure file locker, and encrypted notes application, all running in your terminal with a modern, advanced interface.

Topics

Resources

Security policy

Stars

6 stars

Watchers

1 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

OpenVault

License: MIT Python Version Version Maintenance

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.

Features

  • 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

Security

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

Installation

Prerequisites

  • Python 3.8 or higher
  • pip (Python package manager)

From Source

git clone https://github.com/OR-6/OpenVault.git
cd OpenVault
pip install -r requirements.txt
python main.py

Dependencies

Required packages:

  • cryptography — encryption and key handling
  • pyotp — time-based one-time password generation
  • qrcode — QR code creation for 2FA backups
  • rich — styled command-line interface
  • pillow — image handling for QR decoding

Optional (for advanced QR scanning features):

  • opencv-python — webcam QR scanning
  • pyzbar — QR code decoding

Quick Start

  1. First Run: Launch OpenVault and set your master password:

    python main.py
  2. Add a Password: Password Manager → Add Password

  3. Set Up 2FA: 2FA Authenticator → Add 2FA → Scan QR or enter secret

  4. Store Files: Secure File Locker → Upload File

  5. Create Notes: Secure Notes → Add Note

Usage

Password Manager

  • Add, view, edit, and delete entries
  • Category-based organization
  • Optional password generator
  • Clipboard auto-clear for sensitive fields

2FA Authenticator

  • 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

Secure File Locker

  • Encrypt and store any file type
  • Organized by category
  • Decrypt to a chosen location
  • Option to open decrypted files immediately

Secure Notes

  • Create encrypted text notes
  • Category organization
  • View, edit, and delete notes

Configuration

Vault data is stored locally:

  • Linux/macOS: ~/.config/openvault/
  • Windows: %APPDATA%\openvault\

Key files:

  • vault.enc — Encrypted vault database
  • config.json — App settings
  • locker/ — Encrypted file storage

Contributing

Pull requests are welcome. To contribute:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature-name
  3. Make changes and add tests
  4. Run tests: python -m pytest
  5. Open a pull request

Reporting Issues

Please use GitHub Issues. Include:

  • Python version
  • OS
  • Steps to reproduce
  • Expected vs. actual results

Security Tips

  • 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

License

MIT License — see LICENSE for details.

Disclaimer

While OpenVault uses strong encryption, no software can guarantee absolute security. Use at your own risk and maintain secure backups.

Author

OR-6

Support

  1. Read the documentation
  2. Search issues
  3. Open a new issue if needed

⭐ Star this repo if you find it useful!

About

A secure, offline-first password manager, 2FA authenticator, secure file locker, and encrypted notes application, all running in your terminal with a modern, advanced interface.

Topics

Resources

Security policy

Stars

6 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages