xorify

A simple CLI tool for file obfuscation using XOR encryption.

Features

• Encrypt (lock) or decrypt (unlock) files using a password.
• Optionally keep the original file or replace it in-place.
• Simple, fast, and cross-platform.

Installation

npm install -g @tb.p/xorify

Usage

xorify <file> -p <password> [options]

Arguments

• <file>: Path to the file you want to process (required).

Options

• -p, --password <string>: Password for encryption/decryption (required).
• -l, --lock: Lock (encrypt) the file.
• -u, --unlock: Unlock (decrypt) the file.
• -k, --keep: Keep the original file (otherwise, it will be replaced).

Examples

Encrypt a file:

xorify secret.txt -l -p mypassword

This will create secret.x.txt (encrypted) and remove the original unless --keep is used.

Decrypt a file:

xorify secret.x.txt -u -p mypassword

This will restore the original file name and remove the encrypted one unless --keep is used.

Keep the original file:

xorify secret.txt -l -p mypassword --keep

How it works

• Uses XOR encryption with a key derived from your password (SHA-256).
• Encrypted files are renamed with .x before the extension.
• Decryption expects the .x pattern in the filename.

License

MIT