中文 | English

cryptomator-cli.yazi

Yazi file manager plugin for mounting/unmounting Cryptomator vaults

Features

• 🔍 Auto-detects Cryptomator vaults (.cryptomator files) in current or previewed directory
• ⌨️ Interactive password input for mounting encrypted vaults
• 🔓 Secure vault unmounting functionality
• ⚙️ Configurable mount point location
• 💬 Operation status notifications

Installation

Method 1: Using ya package manager

ya pkg add WayneKent/cryptomator-cli

Method 2: Manual installation

1. Clone repository:

   git clone https://github.com/WayneKent/cryptomator-cli.yazi.git

2. Copy plugin to Yazi plugins directory:

   cp -r cryptomator-cli.yazi ~/.config/yazi/plugins/

3. Ensure cryptomator-cli command is installed on your system

Usage

Mount vault

1. Navigate to directory containing .cryptomator file, or
2. Select target directory in parent directory view
3. Press mc shortcut
4. Enter vault password

Unmount vault

1. Navigate to mounted vault directory, or
2. Select target directory in parent directory view
3. Press uc shortcut

Keybind Configuration

Add to ~/.config/yazi/keymap.toml:

[mgr]
prepend_keymap = [
{ on = ["m", "c"], run = "plugin cryptomator-cli -- --mount", desc = "Mount Cryptomator vault" },
{ on = ["u", "c"], run = "plugin cryptomator-cli -- --umount", desc = "Unmount Cryptomator vault"},
]

or

[[mgr.prepend_keymap]]
on = ["m", "c"]
run = "plugin cryptomator-cli -- --mount"
desc = "Mount Cryptomator vault"

[[mgr.prepend_keymap]]
on = ["u", "c"]
run = "plugin cryptomator-cli -- --umount"
desc = "Unmount Cryptomator vault"

Configuration

Mount directory

Add to ~/.config/yazi/init.lua:

require('cryptomator-cli'):setup({
    mount_parent = '~/mnt' --default
})

Dependencies

• Cryptomator CLI
• FUSE filesystem support

FAQ

Q: Mounting fails?
✅ Check:

1. cryptomator-cli is installed
2. FUSE support exists
3. Correct password

Q: Change default mount location?
⚙️ Modify mount_parent in init.lua config

License

This project is licensed under the MIT License.

Credits

• 🦆 Yazi - Powerful terminal file manager
• 🔐 Cryptomator CLI - Encrypted storage tool