Skip to content

Simple GUI for interactive batch image cropping.

License

Notifications You must be signed in to change notification settings

luphord/blitzcrop

Repository files navigation

blitzcrop

PyPI package Build status

GUI for interactive batch image cropping:

  1. Drag along the diagonal of the image from upper left to lower right corner and release the mouse button.
  2. Move the mouse to the upper right corner and click.
  3. Accept or reject the cropped image in the dialog popping up.

Demo of blitzcrop interaction

Features

  • Batch crop large amounts of images in a short amount of time
  • Drag and click to crop an image
  • Crop rotated images
  • Pass images via command line
  • Navigate between images using left arrow/right arrow or A/D
  • Accept cropped images by Enter or Space and reject them by Esc

Install

You can install blitzcrop using pip with

pip3 install blitzcrop

Alternatively, you can download blitzcrop.py and then run it using python3 with

python3 blitzcrop.py

In this case, you need to ensure that Pillow and tkinter (including ImageTk) is installed on your system and available to python3. If you work on an Ubuntu-based Linux distribution, you may achieve that by means of

sudo apt install python3-tk python3-pil python3-pil.imagetk

History

0.3.0 (2022-10-17)

  • Abort rectangle selection by clicking with the right mouse button or by pressing Esc
  • Specify file name template by -f/--file-name-template with placeholders image and now
  • Specify image quality by -q/--quality
  • Specify -m/--forget-metadata to prevent storing original image metadata in cropped image; otherwise metadata will be preserved (including original image resolution)

0.2.1 (2022-10-10)

  • Support Pillow < 9.10 by monkey-patching Image.Resampling

0.2.0 (2022-10-09)

  • Implement core cropping interaction with drag + click
  • Support multiple images via command line arguments
  • Support basic keybindings for image navigation and crop accept / reject

0.1.0 (2022-04-03)

Credits

Main developer is luphord luphord@protonmail.com. cookiecutter-pyscript is used as project template.

About

Simple GUI for interactive batch image cropping.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published