README file from
Github[!Caution]
- This plugin is designed for personal use and reasonable security needs
- Not recommended for highly classified or mission-critical information
- Always backup your vault before encrypting important files
- The developer is not responsible for any data loss
- Losing the password means losing the file
Next-generation file encryption solution
Eccirian Encrypt is a security-focused Obsidian plugin which provides safe and seamless file encryption. The plugin adds file-level encryption and decryption capabilities to your vault, using AES-256-GCM and ECC-P-256 cryptographic encryption algorithms. By introduces custom file extensions and read-only view for locked files, allowing you to easily manage sensitive information directly in Obsidian. It is also the only plugin that supports one-click encryption of all link attachments.
Features
Eccirian Encrypt provides file-level encryption inside Obsidian.
- Encrypt notes and linked attachments together
- Two file modes:
- Temporary mode (
.eccirian): unlock once, then edit normally - Permanent mode (
.peccirian): stays encrypted on disk and asks for password when opened
- Temporary mode (
- Works with common file types, not only
.md - Includes a read-only view for locked files
- Uses Web Crypto API (
crypto.subtle) for AES operations - Configurable PBKDF2 and Argon2id compliant with OWASP2023 standards
Current platform support is focused on Windows and macOS.
Security & Encryption Algorithms
📦 Installation
Community Plugins (Recommended)
- Open Obsidian Settings
- Go Community Plugins → Browse
- Search for Eccirian Encrypt
- Click Install → Enable
Manual Installation
-
Download the latest
release.zipfrom GitHub Releases -
Extract into:
<your-vault>/.obsidian/plugins/eccirian-encrypt/ -
Reload Obsidian
-
Enable the plugin in Settings → Community Plugins
Quick Start
Encrypt or Decrypt One File
- Open a note
- Use ribbon lock icon, or
Ctrl+P→ "Encrypt / Decrypt file" - Enter password
- File will be converted to
.eccirianor.peccirianbased on current mode
Commands
Convert to Markdown:.peccirianto.mdToggle file Extension: switch.mdand.eccirianEncrypt Folder: encrypt files in a folder while preserving structure
FAQ
Q: What happens if I forget my password?
A: Data cannot be recovered without the password.
Q: Can I use this with Sync?
A: Yes. Encrypted files can be synced like other files.
Q: Does attachment encryption work with Permanent mode?
A: Yes.
Q: Are my passwords stored anywhere?
A: No.
Q: Can I encrypt folders?
A: Yes. Use the folder encryption command from the context menu or command palette.
Q: How is this different from other encryption plugins like Meld Encrypt?
A: Main differences:
- Attachment encryption: This plugin encrypts linked files (images, PDFs, docs) alongside notes. Other plugins typically only encrypt note content.
- Two persistent modes: Permanent mode keeps files encrypted on disk and requires password each time. Temporary mode encrypts but auto-decrypts on open.
- File type flexibility: Works with any file format, not limited to
.md. - Lock screen: Provides a custom read-only interface for encrypted files. The password input box will not be triggered when using the mouse hover preview.
- Encryption methods: Supports both AES-256-GCM and optional ECC hybrid encryption.
- Configurable KDF: Both AES and ECC modes support PBKDF2 and Argon2id with adjustable parameters for flexible security/performance tradeoff.
- Key caching: Can cache decrypted keys temporarily to avoid repeated password prompts during batch operations.
- Platform: Currently Windows and macOS only. Meld Encrypt has broader platform support.
Contributing
Issues and pull requests are welcome: GitHub Issues
MPL-2.0 License © 2026 Entropiex