Obsidian Password Manager

中文文档

Lightweight account, password, and link management inside Obsidian — with encryption, backup, recycle bin, and import/export support.

📖 Introduction

Obsidian Password Manager is a lightweight password management plugin for Obsidian, designed for storing and organizing daily-use credentials directly inside your vault.

It uses a JSON-based data structure and provides a three-column management interface that allows quick switching between groups, entries, and details. For common scenarios such as website accounts, software logins, and simple key records, this approach is lighter and easier to manage alongside your notes.

✨ Features

• 🔐 Encrypted storage – Supports local encryption of the entire password vault. Unlock method and re-verification timing are configurable.
• 📂 Group management – Create custom groups (default, website keys, personal profiles, etc.) for easy classification.
• 🔍 Quick search – Real-time search by title, username, link, note, or group name.
• 💾 Backup & restore – Export all data as a one-click JSON snapshot and restore anytime.
• 📝 Auto-export to Markdown – Automatically sync and export the complete password vault to a specified Markdown file, convenient for read-only access, review, or integration into your note-taking workflow.
• 📤 Import / Export – Supports Markdown / JSON formats for migration or collaboration with other tools.
• 🗑️ Recycle bin – Deleted entries are temporarily stored in the recycle bin and can be restored or permanently removed.

🚀 Installation

Manual installation (BRAT)

1. Install the BRAT plugin.
2. Add https://github.com/yourusername/obsidian-password-manager in BRAT settings.
3. Enable the plugin.

Local manual installation

• Download the latest main.js, manifest.json, and styles.css into your vault's .obsidian/plugins/obsidian-password-manager/ folder.
• Restart Obsidian and enable the plugin.

🔒 Security Notes

• This plugin does not transmit any data over the network; all information remains within your local Obsidian Vault.
• The current encryption implementation is based on the browser's native Web Crypto API: PBKDF2 with SHA-256 is used to derive a key from the user-supplied encryption password, with 250,000 iterations; the actual data is encrypted using AES-GCM 256-bit, with a unique salt and iv generated for each encryption operation.
• When encryption is enabled, the plugin encrypts the entire password vault (data.json) for storage; password verification is performed via a separate verifier ciphertext, without storing the plaintext password in a reversible form.
• If you use Git to sync your vault, make sure .gitignore excludes any encryption key files (if present), or be aware that the ciphertext inside the JSON files will be committed.

If you need more comprehensive professional password management capabilities, this plugin is better suited as a lightweight recording tool rather than a full replacement for dedicated password managers.

📝 Development & Contribution

• Repository: https://github.com/yourusername/obsidian-password-manager
• Issues, PRs, and suggestions are welcome.
• Local development:

git clone ...
npm install
npm run dev

👏 Acknowledgments

Developed by PandaNocturne.

📄 License

MIT