Skip to content

Home

Jump to bottom
Jack Murray edited this page Jan 9, 2026 · 6 revisions

🚀 Black Hole Password Manager

Black Hole is a secure, user-friendly password manager. It stores passwords in an encrypted SQLite database, supports features like pinning to the system tray, exporting/importing data, and automatic update checks. Designed for simplicity and security, it uses Fernet encryption derived from a master password.

📋 Features

  • 🔒 Secure Storage: Encrypts passwords using cryptography's Fernet with a master password-derived key.
  • 📝 Entry Management: Add, edit, delete, and search password entries with titles, usernames, passwords, and notes.
  • 📌 Pinning: Pin frequently used entries to the system tray for quick clipboard access.
  • 📤 Export Options: Export vault to .docx, .odt, or .xlsx formats.
  • 📥 Import: Import entries from Excel (.xlsx) or CSV files.
  • 🔍 Search and Sort: Filter entries by title; sort by default, A-Z, Z-A, or custom order.
  • 🛡️ Master Password: Required for access; supports setup for new vaults or importing existing ones with a sync key.
  • 🖼️ Custom Icons: Upload icons for entries.
  • 🔔 System Tray Integration: Minimize to tray and launch with Windows.
  • 🔄 Auto-Update: Checks for updates from GitHub releases.

🛠️ Installation

  1. Download the setup file from the latest release
  2. Run the installer to setup the program

📖 Usage

🔑 Setting Up

  • On launch, if no vault exists, choose "New Vault" (select a folder) or "Import Vault" (select .db file and provide sync key).
  • Create a strong master password. Optionally save it to a file.
  • For imports, enter the sync key (base64-encoded salt) for decryption.

➕ Adding Entries

  • Click the "+" button.
  • Enter a title (required) and create.

✏️ Editing Entries

  • Click "Edit" on a card.
  • Update title, username, password, notes.
  • Upload an icon (PNG/JPG/ICO; auto-resized to 350x350).
  • Toggle pinning for tray access.

🗑️ Deleting Entries

  • Click "Delete" on a card and confirm.

🔍 Searching

  • Use the search bar to filter by title.

🔄 Sorting

  • Choose from Default (recent first), A-Z, Z-A, or Custom.
  • In Custom mode, click "Edit Order" to reorder (up/down arrows).

📌 Tray Features

  • Minimize to tray if enabled in settings.
  • Right-click tray icon for menu: Open, Exit, or copy pinned passwords.
  • Double-click tray icon to restore window.

⚙️ Settings

  • Launch with Windows.
  • Minimize to Tray.
  • Theme (System, Light, Dark)
  • About (version, license).
  • Reset (deletes settings/icons, not database).

📤 Exporting

  • Click "📤" and choose format.
  • Verify master password.
  • Save decrypted data as .xlsx, .docx or .odt.

📥 Importing

  • Click "📥" and select .xlsx.
  • Map columns to Title (required), Username, Password, Notes.
  • Entries are encrypted on import.

⚠️ Security Notes

  • Master password is never stored; it's used to derive the encryption key.
  • Sync key (salt) allows importing the vault on other devices—keep it secure.
  • Database file (.db) contains encrypted data; back it up.
  • No cloud sync; manual file transfer recommended.

🤝 Contributing

Contributions welcome! Fork the repo, create a branch, and submit a pull request. Focus on bug fixes, features, or documentation.

📄 License

© Nova Foundry 2025-2026. All rights reserved.

This work is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License (CC BY-ND 4.0).

You are free to:

  • Share: copy and redistribute the material in any medium or format.

Under the following terms:

  • Attribution: You must give appropriate credit to Nova Foundry, provide a link to the license, and indicate if changes were made.
  • NoDerivatives: If you remix, transform, or build upon the material, you may not distribute the modified material.

No additional restrictions:

  • You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.

For full license text, see: https://creativecommons.org/licenses/by-nd/4.0/

THE WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE WORK OR THE USE OR OTHER DEALINGS IN THE WORK.

Developed by Nova Foundry. Support us at Buy Me a Coffee.

Clone this wiki locally