53c08db9fe
#### **Security & Stability** * **Tamper Protection:** Added a sentinel file to verify vault integrity. If `data.json` is missing or modified, the plugin now triggers a "Hard Lock" to prevent unauthorized access. * **Decryption Guard:** Disabling note encryption now requires a mandatory decryption pass to ensure no files are left permanently locked on disk. * **Timer Fix:** Resolved a race condition where the auto-lock timer could fire during note processing, preventing "half-locked" states. #### **Lockscreen & Visuals** * **Atmospheres:** Replaced generic themes with four curated presets (Minimal, Noir, Frosted, and Vivid) that style the blur, overlays, and typography. * **Typography:** Fixed a bug where custom fonts only applied to the username; they now correctly skin all lockscreen text. #### **Interface & UX** * **Settings Overhaul:** Reorganized the settings panel into a cleaner, more logical flow from account security to aesthetics. * **Visual Previews:** Added video thumbnail previews directly in the background settings. * **Input Tuning:** Added granular controls for password bar rounding and "shake" animation intensity. * **Scaling Fix:** Rebuilt the UI scaling system to ensure text remains sharp and hit-boxes remain accurate at all sizes. * **Reduced Friction:** Removed the redundant "Inactivity" popup; the lockscreen now serves as its own notification. |
||
|---|---|---|
| .gitignore | ||
| bg.mp4 | ||
| esbuild.config.mjs | ||
| index.js | ||
| LICENSE | ||
| main.js | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| styles.css | ||
VaultGuard
VaultGuard is a secure, beautiful, and highly customizable lockscreen plugin for Obsidian. It protects your vault from unauthorized access with industry-standard encryption, while offering personalization features to match your unique workflow and style.
This plugin is built with a security-first mindset, ensuring your sensitive notes remain private. It has been hardened for stability and performance, providing a seamless and reliable user experience.
Features
Security
- Strong Encryption: Utilizes AES-GCM, an authenticated encryption standard that provides both confidentiality and data integrity.
- Resilient Key Derivation: Implements PBKDF2 with a high iteration count (250,000) and a secure random salt to protect your password against modern brute-force attacks.
- Password Strength Meter: Integrated zxcvbn analysis gives you real-time, intelligent feedback to help you choose a strong and secure password.
Personalization
- Dynamic Backgrounds: Set a video, image, or solid color as your lockscreen background. Use the defaults, add from a web URL, or upload your own files.
- Personalized Greeting: Display a custom username on the lockscreen with your choice of font, weight (bold), and style (italic).
- UI Scaling & Sizing: Adjust the overall size of lockscreen elements and the width of the password input to perfectly fit your display and preference.
Functionality
- Optional Full Vault Encryption: For maximum security, enable the option to encrypt every .md file in your vault. Files are decrypted automatically upon unlock.
- Performant Processing: Note encryption/decryption is performed in batches, preventing UI freezes even in vaults with thousands of notes.
- Resilient Operation: A single corrupted note will not halt the entire decryption process, ensuring you can always access the rest of your vault.
- Auto-Lock Timer: Automatically lock your vault after a configurable period of inactivity.
Installation
From the Community Plugins Store (Not approved yet)
- Open Settings in Obsidian.
- Go to Community Plugins and make sure "Restricted mode" is off.
- Click Browse and search for "VaultGuard".
- Click Install, and then click Enable.
- Open the VaultGuard settings to set your master password!
Manual Installation
- Download the latest main.js, manifest.json, and styles.css from the releases page.
- Download the latest zxcvbn.js and bg.mp4 from the main page.
- Navigate to your Obsidian vault's plugin folder: /.obsidian/plugins/.
- Create a new folder named VaultGuard.
- Place the five downloaded files inside this new folder.
- In Obsidian, go to Settings -> Community Plugins and enable "VaultGuard".
Getting Started
- Set Your Password: After installing, go to the VaultGuard settings tab. You will be prompted to create your master password.
- Lock Your Vault:
- Click the Lock icon in the left ribbon.
- Use the command palette (Ctrl/Cmd + P) and run "VaultGuard: Lock Vault".
- Wait for the auto-lock timer to expire (if enabled).
- Customize: Head back to the VaultGuard settings at any time (while unlocked) to change your password, configure the auto-lock timer, and customize your lockscreen.
⚠️ CRITICAL: Read Before Enabling Note Encryption
This plugin offers a powerful feature to Encrypt Notes on Disk. Before you enable this, you must understand and accept the following risks:
FORGOTTEN PASSWORDS CANNOT BE RECOVERED. If you enable note encryption and forget your password, your notes will be PERMANENTLY AND IRREVOCABLY LOST. There is no "Forgot Password" feature. There is no backdoor. We cannot help you recover your files.
ALWAYS BACK UP YOUR VAULT. This is critical for all users, but it is ESSENTIAL if you enable note encryption. Back up your vault before you enable this feature for the first time, and maintain regular backups. If anything goes wrong (e.g., file corruption, software bug), a backup is your only safeguard.
This feature provides a very high level of security, but it comes with significant personal responsibility. Please proceed with extreme caution.
Contributing
This plugin is for the community. If you find a bug, have a feature request, or want to contribute to the code, please feel free to open an issue or pull request on the GitHub repository.
License
This plugin is released under the MIT License. See the LICENSE file for more details.