Eccirian Encrypt

[!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 uses AES-256-GCM and ECC-P-256 algorithms, and 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 (so far) that supports one-click encryption of all link attachments.

Features

You could:

• 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
• 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
• Preview medias in Permanent mode editor
• Desktop and mobile devices support

Security & Encryption Algorithms

📦 Installation

Community Plugins (Recommended)

1. Open Obsidian Settings
2. Go Community Plugins → Browse
3. Search for Eccirian Encrypt
4. Click Install → Enable

Manual Installation

1. Download the latest release.zip from GitHub Releases

2. Extract into:

   <your-vault>/.obsidian/plugins/eccirian-encrypt/
   

3. Reload Obsidian

4. Enable the plugin in Settings → Community Plugins

Quick Start

Encrypt or Decrypt One File

1. Open a note
2. Use ribbon lock icon, or Ctrl+P → "Encrypt / Decrypt file"
3. Enter password
4. File will be converted to .eccirian or .peccirian based on current mode

Commands

• Convert to Markdown: .peccirian to .md
• Toggle file Extension: switch .md and .eccirian
• Encrypt 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.

Contributing

Issues and pull requests are welcome: GitHub Issues

MPL-2.0 License © 2026 Entropiex