Readme

README.md

@@ -71,4 +71,38 @@ sort                        sort files as AAABBB -> ABABAB
     -m=<num> (auto)         specify midpoint (cover image)
     -prerotated             images are already rotated
 strip                       strip exif crop values from images with exiftool
-```
+```
+
+#Typical Usage
+
+digicam images are sorted into Left-Right page spreads
+
+`leaf sort -prerotated canon/`
+
+images are analized to determine rotation angle
+
+`leaf deskew -contrast=50 canon/`
+
+images are selected as "crop templates"
+
+`leaf crop -crops=4 canon/`
+
+intermediate images are generated from crop/skew/format tags
+
+`leaf generate -pixels=1800 -inches=8.5 -q=90 -levels=10,1,225 -px=2 canon/`
+
+intermediate images are assembled into a PDF
+
+`leaf build canon_generated/`
+
+#Dependencies
+
+* [ImageMagick](https://github.com/ImageMagick/ImageMagick)
+* [VIPS](https://github.com/jcupitt/libvips)
+* [exiftool](https://github.com/exiftool/exiftool)
+* [exiv2](https://github.com/Exiv2/exiv2)
+* [img2pdf](https://gitlab.mister-muffin.de/josch/img2pdf)
+* [pdftk](https://www.macports.org/ports.php?by=name&substr=pdftk)
+* [trash](http://hasseg.org/trash) (for gentle deletion)
+* [iTerm](https://www.iterm2.com) (for inline image previews)
+* [Bridge](https://www.adobe.com/products/bridge.html) (for tweaking crops)