pixzle

This npm package provides functionality for image fragmentation and restoration.

Note: This does not guarantee strong security.

Requirements

• Node >= 20

Packages

See each package README for usage details.

Platform	Package	Shuffle	Restore
CLI	@pixzle/cli	✅	✅
Node.js	@pixzle/node	✅	✅
Browser	@pixzle/browser	-	✅
React	@pixzle/react	-	✅

Clients

Client	OS	Shuffle	Restore
App	Mac | Win	✅	✅
Raycast	Mac	✅	✅

Quick Start (CLI)

You can easily try image fragmentation using the CLI.

# Install CLI
npm install -g @pixzle/cli

# Shuffle images
pixzle shuffle input.png -o ./output

# Restore images
pixzle restore ./output/*.png -m ./output/manifest.json -o ./restored

Shuffle Overview

Result Example

Fragmented	Restored

List by blockSize

You can change the block size with -b or --block-size <number>.

input	blockSize: 1	blockSize: 2	blockSize: 3	blockSize: 4

blockSize: 8 (default)	blockSize: 16	blockSize: 32	blockSize: 50	blockSize: 128

Warning

• May cause memory shortage depending on the value of block size.