Bender is a data-bending toolkit that turns images into sound and back. Process the generated audio to create visual artifacts, use the built-in image and audio effects, or watch files for an automatic experimentation loop.

Quick start

Bender requires Python 3.12+ and uv.

git clone https://github.com/meownoid/bender.git
cd bender
uv tool install --reinstall .

Convert an image to a WAV and JSON metadata sidecar:

bender convert image.jpg

After processing the WAV in an audio tool, convert it back. Bender finds the matching JSON file from the filename:

bender convert image-a1b2c3d-processed.wav

Explore the installed algorithms and their parameters:

bender convert --list
bender edit --list
bender process --list

Documentation

See the documentation index for installation, conversion workflows, image editing, audio processing, Fujifilm RAW support, monitoring, shell completion, and contributor guides.

Bender is available under the MIT License. This product includes DNG technology under license by Adobe.