Rastry documentation
Rastry is a local-first tool for optimizing, transforming, and organizing image batches. The CLI and Desktop v0.2 workflow use the same TypeScript contracts, so a pipeline is readable, repeatable, and safe to run again.
Start here
Section titled “Start here”- Install Rastry from a standalone CLI binary or Desktop installer.
- Follow the quickstart for a single image and a preset batch.
- Choose the CLI reference for scripts, CI, and agents.
- Choose the Desktop workflow for selecting files and reviewing a plan visually.
Product boundaries
Section titled “Product boundaries”Rastry supports PNG, JPEG, and WebP input and output on every platform. HEIC input and output are available through the system codec on macOS and Windows; Linux keeps HEIC out of Desktop controls. The current operation set is resize, crop, transparent trim, padding, conversion with quality, and metadata removal.
Background removal, OCR, AVIF, screenshots, cloud processing, accounts, and watch mode are not shipped capabilities. See the roadmap for the intended sequence.
The safety contract
Section titled “The safety contract”Every run can be planned before it writes. Dry-run is the default CLI behavior, and Desktop shows a plan preview before execution. Outputs use a derived name or an explicit output directory; originals and existing files are not silently replaced. Read the full safety model.