COOKERY Cory Arcangel & Henry Van Dusen
A "deep frying" command-line utility which can randomly generate "deep frying" scores, and playback those scores on an image or on the frames of a video file (with optional key-framing!).
Requires imagemagick 77A7 , realpath, and video support requires FFMPEG.
required args:
-fimage_file (default: spongebob.jpg)
You can also always add the image file as the last argument without -f
optional args:
-niterations (default: 5)-ssave every (default: 1)-hgenerated recipe filename (default: recipe.txt)-rrecipe file to cook with (default: null)- must be a recipe file that resulted from cooking
-nand-harguments will be ignored
-ooutput_directory (default: autogenerated based on date/time)-lonly generate the last image (default: false. just include -l to turn on)-nargument will be ignored
INSTALLATION:
Run the installation script to add the cook executable to your path:
sudo ./install.sh
USAGE:
cook -o output_folder spongebob.jpg
By default, cooking steps will be saved to a file called recipe.txt. To use a different name, use -h [filename].
When we run
cook -h my_recipe.txt -o output_folder -f spongebob.jpg
we should see these files in output_folder:
my_recipe.txt
spongebob-step-1.jpg
spongebob-step-2.jpg
spongebob-step-3.jpg
spongebob-step-4.jpg
spongebob-step-5.jpg
Here's spongebob-step-5.jpg:
We can reuse output_folder/my_recipe.txt on other images! To replay a recipe file, pass the -r flag to cook:
cook -r output_folder/my_recipe.txt -o output_folder -f mr-krabs.jpg
Here's the resulting mr-krabs-step-5.jpg, cooked with my_recipe.txt:
COOK A VIDEO
cook works with video! Here's how to cook a video at 60 frames per second (the default is 30fps), saving all generated files in the video-output folder:
cook -r recipe.txt -fr 60 -o video-output vid.mp4
This script generates individual frames from the video at the specified framerate, saves cooked versions of each frame following the recipe file into a cooked subfolder, and recombines those frames back into a video called out.mp4 in cooked.
COOKERY DIRECTOR: -d
Instead of using a single recipe file to cook all frames of a video, you can provide a combination of recipe files and specify which frames they apply to using the Cookery Director flag, -d. This points to a director file.
The director file contains one or more lines containing this format:
[starting frame],[required recipe file],[optional recipe file for keyframing]
For example:
1,recipe1.txt
200,recipe2.txt,recipe3.txt
800,recipe3.txt
This file will apply recipe1.txt to frames 1-199. Then from frame 200-799, recipe2.txt will be applied with decreasing strength, while recipe3.txt will be applied with increasing strength. This achieves a keyframe-like effect (!!!!!!!) Then recipe3.txt will be applied from frame 800 to the final frame. Each recipe file is given as its relative path from the director file.
cook -d ./director -fr 60 -o video-output vid.mp4
Hot tip: to see how many frames are in a video, use the
-fcflag:cook -fc vid.mp4 total frames: 150Hot tip: generate a ton!
for i in {1..10}; do input=spongebob.jpg; output=$(date +"%d-%m-%Y-%H-%M-%S")-$input; mkdir $output;./cook -n 100 -o $output -f $input; done
Published by Arcangel Surfware (SRF-061)
A lightweight browser is deployed to github pages. No build-step required—just open index.html in a modern browser.
- Choose an image.
- Set iterations and strength.
- Hit Cook! to let the algorithm work its culinary magic.
- Download the resulting image.
Internally, the browser client re-implements a subset of ImageMagick operations using Canvas 2D APIs and JavaScript. Exact parity with the shell script isn't guaranteed, but the cooking spirit is preserved.