Skip to main content

Visually crop an image under various constraints.

Project description

tl.gcrop: Introduction and usage

The goal of this program is to allow cropping an image using the mouse and having visual feedback while at the same time applying various mathematical constraints such as maintaining a given aspect ratio or ensuring minimal values for the crop margins.

The current state of implementation does visual cropping but doesn’t yet take into account constraints. Also, the output of the program is only the crop coordinates; the cropped image cannot be saved yet.

tl.gcrop requires pygtk to be installed.

Key bindings:


Open a new image, replacing the previous one without warning.

Mouse actions inside the image window:

Left button:

Change crop margins if the mouse is outside the crop area (one if it’s outside an edge, two if it’s outside a corner), otherwise move the crop area without changing its size.

Scroll wheel:

Zoom the image up or down by factors of 2.

Widgets on the right panel:

  • A line describing the current crop area (left and top margin, width and height) that can be copied using mouse selection.

  • Input fields that allow setting all crop parameters to exact pixel values.

  • Two preview windows that show the cropped image and the crop area relative to the total image.

About tl.gcrop


Thomas Lotze (,

PyPI page:

Issue tracker:

Source code:

Current change log:

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tl.gcrop-0.1.tar.gz (12.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page