Encrypt images into a sibling truyendrive/ directory using scanline scrambling by default, with a legacy XOR-noise transform still available. Encrypted folders can be decrypted back into a colocated decrypted/ directory.

Install

npm install
npm run build

Publish

For maintainers:

npm login
npm version patch
npm publish

After publish, anyone can run:

npx truyendrive-cli <directory>

If you want to verify the exact tarball before publishing:

npm pack --dry-run

Usage

npx truyendrive-cli <directory> [--decrypt] [--mode folder|subfolder] [--encryption scanline|noise] [--key KEY] [--batch-size N] [--compression-level 0-9] [--effort 1-10] [--overwrite] [--no-copy-other-files] [--no-generate-password-file]

Options:

directory: required source directory
--decrypt: reverse encryption for an already-encrypted truyendrive/<name>/ source directory
--mode: folder or subfolder, defaults to folder
--encryption: scanline or noise, defaults to scanline
--key: PRNG seed key, defaults to truyendrive
--copy-other-files / --no-copy-other-files: copy non-image files to destination, defaults to --copy-other-files
--no-generate-password-file: disable generation of .password.<key>.<method>.truyendrive in destination if none found in source
--batch-size: maximum number of concurrent image jobs per unit
--compression-level: PNG compression level from 0 to 9, defaults to 6
--effort: PNG encoder effort from 1 to 10, defaults to 7
--overwrite / --no-overwrite: defaults to --no-overwrite

Layout

folder mode writes to parent(directory)/truyendrive/<directory-name>/
subfolder mode writes each immediate child folder to parent(directory)/truyendrive/<directory-name>/<child-name>/
decrypt mode writes to parent(encrypted-directory)/decrypted/<encrypted-directory-name>/

Only supported image files are processed. Output filenames preserve the source basename and normalize the extension to .png.

Encryption methods:

scanline: pixel-only reversible scrambling that rolls/reverses each row with keyed offsets while preserving PNG compression better than full row shuffling.
noise: legacy XOR-noise transform; this usually creates much larger PNG files.