update to jepler

README.md

@@ -7,8 +7,8 @@ write the result.
 
 It turns out that debian's jpegtran has a "-crop" flag which performs lossless
 cropping of jpeg images as long as the crop is to a multiple of what the
-manpage calls the "iMCU boundary", a (usually?) 8x8 block of pixels. This
-feature may have been pioneered by Guido of jpegclub.org some years ago.
+manpage calls the "iMCU boundary", usually an 8x8 or 16x16 block of pixels.
+This feature may have been pioneered by Guido of jpegclub.org some years ago.
 
 There's apparently a nice Windows front-end to this program, but I didn't find
 a Linux one. So I wrote one! It's pretty basic, but it gets the job done. You
@@ -22,15 +22,45 @@ overwrite an earlier cropped version). For example, if the input is "moon.jpg"
 then the output is "moon-cropped.jpg".
 
 Images are automatically scaled by a power of 2 (e.g., 1/2, 1/4 or 1/8) in
-order to fit onscreen. After releasing the mouse button, the cropped image
-boundary may move a little bit; this represents the limitation that the
-upper-left corner must be at a multiple of 8x8 original image pixels.
+order to fit onscreen. While dragging, the cropped image boundary will snap
+to a multiple of 8 or 16 pixels; this represents the limitation that the
+upper-left corner must be at a multiple of the iMCU blocks.
 
-cropgui is written in Python and requires python, python-tkinter,
-python-imaging, python-imaging-tk, and libjpeg-progs. It is available under the
-terms of the GNU GPL version 2 or later. 
+## PREREQUISITES
+
+cropgui is written in Python and requires the following packages:
+ * Debian: python3, python3-pil, python3-pil.imagetk,
+   (python-tkinter, python-imaging, python-imaging-tk on older systems),
+   libjpeg-progs, and libimage-exiftool-perl.
+ * Fedora: `dnf install python2-pillow  libjpeg-turbo-utils  pygtk2 pygtk2-libglade  ImageMagick  and perl-Image-ExifTool python3-pillow-tk`.
 
 The specific external programs required are:
  * `jpegtran` to crop jpeg images (debian package: libjpeg-turbo-progs or libjpeg-progs)
- * `jpegexiforient` to clear the EXIF rotation flag from jpeg output images (debian package: libjpeg-turbo-progs or libjpeg-progs)
+ * `exiftool` to clear the EXIF rotation flag from jpeg output images (debian package: libimage-exiftool-perl)
  * `convert` to rotate and crop other image types (debian package: imagemagick or graphicsmagick-imagemagick-compat)
+ * `magick` on Windows (download from ImageMagick and install)
+
+## INSTALLATION
+
+Although there are packages in the making, for a system-wide install, first make sure
+prerequisites are met for your system and the "flavor" of cropgui you want to install.
+For the GTK version, you may skip the TK dependencies. But make sure `jpegtran`, `exiftool`
+and `convert` are installed.
+
+Then do this on command line after cloning this repo:
+
+    $ sudo bash ./install.sh -p /usr -P /usr/bin/python
+
+Where the _-p_ flag tells install.sh to install to /usr instead of your home dir. And
+flag _-P_ points to your python binary, which you can find via _$ type python_. You may
+set the optional -f flag to switch between _tk_ and _gtk_ (the default) flavor of the app.
+
+## Development status
+
+The author (@jepler) is not actively developing this project.
+Issues and pull requests are not likely to be acted on.
+I would be interested in passing this project to a new maintainer.
+
+
+## LICENSE
+cropgui is available under the terms of the GNU GPL version 2 or later.