Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add install notes to README #54

Merged
merged 2 commits into from
Dec 23, 2017
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 21 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,34 @@ 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)
* `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, 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.

## LICENSE
cropgui is available under the terms of the GNU GPL version 2 or later.