中文版

qrypt

qrypt turns your cloud drives into one encrypted local folder — mount it, open it, use it like any other drive.

Introduction

qrypt maps your cloud drives into a single encrypted local folder. Once mounted, you can browse and edit files as if they were on a local disk.

• Single mount point — all drives appear under one directory, each in its own subdirectory
• Encrypted storage — filenames and content are encrypted before they reach the cloud, compatible with rclone crypt
• Staged writes and local cache — writes land locally first and upload in the background; repeated reads hit the cache
• Cross-platform — macOS, Linux, and Windows
• Works without mounting — qrypt fs reads and writes remote files directly, useful in scripts and on servers

Install

Linux / macOS

curl -fsSL https://github.com/yinzhenyu-su/qrypt/releases/latest/download/install.sh | sh

Windows (run in any terminal; no need to open PowerShell first)

powershell -c "irm https://github.com/yinzhenyu-su/qrypt/releases/latest/download/install.ps1|iex"

The installer picks the right build for your system and needs no administrator rights. Open a new terminal afterwards and run qrypt version to confirm.

Update or remove qrypt later with qrypt upgrade and qrypt uninstall (see the quickstart).

Quick Start

The example below uses a local directory, so no cloud account is required. It covers configuration, upload, read, and encryption.

1. Create a config file

version = "1"

[mount]
mount_point = "~/Qrypt"

[[mounts]]
name = "local"
type = "localfs"

[mounts.params]
root_path = "/tmp/qrypt-data"

[mounts.encryption]
password = "my-password"
filename_encryption = "standard"
filename_encoding = "base32"

2. Upload and read a file

mkdir -p /tmp/qrypt-data
echo "hello qrypt" > /tmp/hello.txt

qrypt fs list /
qrypt fs put /tmp/hello.txt /local/hello.txt
qrypt fs cat /local/hello.txt

The last command prints hello qrypt.

3. Inspect the encryption

ls /tmp/qrypt-data

The filename is now an obfuscated string such as b4l6gr1s6t1q0tas6dl0q0mb0s62kbj0, and the file content is encrypted as well.

Mount as a Local Folder (Optional)

qrypt mount

Open ~/Qrypt in your file manager and use it like any other folder: drag files in, open them, delete them.

Only mount needs FUSE: install macFUSE on macOS or WinFsp on Windows. The fs commands do not need it.

Detailed walkthrough (including Windows notes) → Quickstart

Requirements

Dependency	macOS	Linux	Windows
FUSE	macFUSE	libfuse3 / fuse3	WinFsp
Go (source build only)	1.27+	1.27+	1.27+

Config files are discovered automatically: ./qrypt.toml, ~/.qrypt/qrypt.toml, then $XDG_CONFIG_HOME/qrypt/qrypt.toml on Unix or %AppData%\qrypt\qrypt.toml on Windows. You can skip --config when the file is at one of these paths (see CLI Reference).

User Documentation

• Quickstart — install, upgrade and uninstall, minimal config, a first run in about 5 minutes, encryption demo
• CLI Reference — commands, arguments, config discovery paths
• Offline Download — hand magnet links or downloads to the cloud drive
• Troubleshooting — stale mounts, upload queue, and other common issues
• Full Config Reference — all configuration options
• Supported Drivers — driver parameters and examples

Developer Documentation

• Architecture — layer overview and design rules
• Package boundaries — ownership, forbidden dependencies, and migration criteria
• Driver Development — how to add a new cloud-drive backend
• Debugging — diagnostic tools and troubleshooting
• Fuzz Corpus — nightly fuzzing and regression corpus lifecycle
• Quality Gates — CI workflows, coverage gate, contract matrix
• Developer FAQ — recurring implementation issues and fixes

Building from Source

Requires Go 1.27+ and FUSE headers (libfuse3-dev on Linux, macFUSE on macOS). Linux builds use FUSE3 by default; mounting also requires the fuse3 runtime and /dev/fuse. Legacy FUSE2 builds can be produced with -tags fuse2.

git clone https://github.com/yinzhenyu-su/qrypt.git
cd qrypt
go build ./cmd/qrypt

License

MIT