Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/luphord/blitzcrop

Simple GUI for interactive batch image cropping.
https://github.com/luphord/blitzcrop

crop gui image image-processing

Last synced: about 2 months ago
JSON representation

Simple GUI for interactive batch image cropping.

Host: GitHub
URL: https://github.com/luphord/blitzcrop
Owner: luphord
License: mit
Created: 2022-04-03T20:14:20.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2022-10-17T18:45:02.000Z (about 2 years ago)
Last Synced: 2023-12-16T15:12:51.245Z (about 1 year ago)
Topics: crop, gui, image, image-processing
Language: Python
Homepage:
Size: 1.4 MB
Stars: 3
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- License: LICENSE

Awesome Lists containing this project

README

# blitzcrop

[![PyPI package](https://img.shields.io/pypi/v/blitzcrop)](https://pypi.python.org/pypi/blitzcrop)
[![Build status](https://github.com/luphord/blitzcrop/actions/workflows/lint-test.yml/badge.svg)](https://github.com/luphord/blitzcrop/actions)

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](https://github.com/luphord/blitzcrop/raw/main/img/demo.gif)

## 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

```bash
pip3 install blitzcrop
```

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

```bash
python3 blitzcrop.py
```

In this case, you need to ensure that [Pillow](https://pillow.readthedocs.io) 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

```bash
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)
* Created using [cookiecutter-pyscript](https://github.com/luphord/cookiecutter-pyscript)

## Credits

Main developer is luphord . [cookiecutter-pyscript](https://github.com/luphord/cookiecutter-pyscript) is used as project template.