From 0ff9b2f45c3284b3e5cb155b56d7cf0739000c96 Mon Sep 17 00:00:00 2001 From: isync Date: Sat, 23 Dec 2017 15:50:13 +0100 Subject: [PATCH 1/2] Add install notes to README to tell people like me what to do with install.sh --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 22f408c..7bd7201 100644 --- a/README.md +++ b/README.md @@ -38,3 +38,13 @@ The specific external programs required are: * `jpegtran` to crop jpeg 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) + +## INSTALLATION + +Although there are packages in the making, for a system-wide install, 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_ From a77e1872bcc46406432cc12e0f809ca9b0ad52bb Mon Sep 17 00:00:00 2001 From: isync Date: Sat, 23 Dec 2017 16:06:33 +0100 Subject: [PATCH 2/2] --amend last commit --- README.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 7bd7201..6def228 100644 --- a/README.md +++ b/README.md @@ -26,14 +26,14 @@ 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. +## PREREQUISITES + cropgui is written in Python and requires the following packages: * Debian: python, python-tkinter, python-imaging, python-imaging-tk, libjpeg-progs, and libimage-exiftool-perl. * Fedora: python2-pillow, libjpeg-turbo-utils, pygtk2, pygtk2-libglade, ImageMagick, and perl-Image-ExifTool. -It is available under the terms of the GNU GPL version 2 or later. - The specific external programs required are: * `jpegtran` to crop jpeg 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) @@ -41,10 +41,19 @@ The specific external programs required are: ## INSTALLATION -Although there are packages in the making, for a system-wide install, do this on -command line after cloning this repo: +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_ +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. + +## LICENSE +cropgui is available under the terms of the GNU GPL version 2 or later. +