CLI reference¶

After installing with pip install bitsplit, the bitsplit command is available.

`bitsplit encode`¶

Split a file into a binary block and a key.

bitsplit encode <input_file> [-d DATA] [-k KEY]

Argument	Default	Description
`input`	(required)	Source file path
`-d`, `--data`	`data.bin`	Output block file path
`-k`, `--key`	`key.txt`	Output key file path

Examples¶

# Default output files
bitsplit encode photo.jpg
# → data.bin (1,105,407 bytes)
# → key.txt  (one line)

# Custom output paths
bitsplit encode photo.jpg -d photo.dat -k photo.key

# Encode to a specific directory
bitsplit encode report.pdf -d /vault/report.dat -k ~/keys/report.key

`bitsplit decode`¶

Restore a file from a block and a key.

bitsplit decode <output_file> [-d DATA] [-k KEY]

Argument	Default	Description
`output`	(required)	Restored file path
`-d`, `--data`	`data.bin`	Input block file path
`-k`, `--key`	`key.txt`	Input key file path

Examples¶

# Default input files
bitsplit decode restored.jpg

# Custom input paths
bitsplit decode restored.jpg -d photo.dat -k photo.key

Exit codes¶

Code	Meaning
`0`	Success
`1`	Error (file not found, invalid key, etc.)