TurboCrypt

A fast, easy-to-use, and secure command-line tool for encrypting and decrypting files, Git repositories, and directory trees.

Installation

Linux, macOS, and Windows binaries are available from the releases page.

To build an optimized binary locally, install the master version of Zig, then run:

git clone https://github.com/jedisct1/turbocrypt.git
cd turbocrypt
zig build -Doptimize=ReleaseFast

The binary is written to zig-out/bin/turbocrypt.

See the getting started guide for a detailed walkthrough.

Quick start

Create a key and save it as the default:

turbocrypt keygen secret.key
turbocrypt config set-key secret.key

Keep a backup of the key somewhere separate.

Losing it means losing access to the encrypted files, and anyone with a copy can decrypt them.

Encrypt a directory, authenticate the encrypted copy, and decrypt it again:

turbocrypt encrypt my-documents/ encrypted-documents/
turbocrypt verify encrypted-documents/
turbocrypt decrypt encrypted-documents/ restored-documents/

The same commands work on individual files.

Read Getting started for the full tutorial or the command reference for the complete command set.

Documentation

• Getting started: installation and a first encrypted file or directory

• Usage guide: password-protected keys, contexts, filenames, exclusions, verification, and other common workflows

• Private files in Git: encrypted files in public repositories, setup, collaboration, and conflict handling

• Command reference: commands and processing options at a glance

• Configuration: saved settings, precedence, environment variables, and file portability

• Cryptography: key derivation, file and filename encryption, password protection, and Git metadata authentication

• Safety: key handling, backups, verification, and performance considerations

• Troubleshooting: common errors and Git integration problems