https://github.com/weclaw1/inbac

Python application for fast interactive image cropping
https://github.com/weclaw1/inbac

cropping image-manipulation python3

Last synced: 13 days ago
JSON representation

Python application for fast interactive image cropping

• Host: GitHub
• URL: https://github.com/weclaw1/inbac
• Owner: weclaw1
• License: mit
• Created: 2019-10-21T06:30:20.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-15T19:41:42.000Z (4 months ago)
• Last Synced: 2024-08-01T22:55:27.913Z (3 months ago)
• Topics: cropping, image-manipulation, python3
• Language: Python
• Homepage:
• Size: 16.8 MB
• Stars: 322
• Watchers: 4
• Forks: 37
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# inbac

[![Donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/weclaw1/donate)

![](https://raw.githubusercontent.com/weclaw1/inbac/master/resources/demo.gif)

## Description

inbac is an **in**teractive **ba**tch **c**ropper made for quick cropping of images.  

I made this program because cropping thousands of images with image viewers or image manipulation programs was too slow.

## Installation

The easiest way to use this application is to download the single file executable created with PyInstaller, which can be found on the releases page.

If you have python installed you can install with pip by typing:

`pip install inbac`

If you want to use the current master branch you can clone the repository and run the project using poetry.

## Development Requirements

- [poetry](https://github.com/sdispater/poetry)

- tkinter

After installing above dependencies run `poetry install` in project directory to install remaining dependencies.

## Examples

`poetry run inbac /home/user/pictures/`  

Opens images in /home/user/pictures/ and saves cropped images to /home/user/pictures/crops

`poetry run inbac -a 1 1 -r 256 256 /home/user/pictures/ /home/user/crops/`  

Opens images in /home/user/pictures/ in 1:1 ratio selection mode and saves images resized to 256x256px in /home/user/crops/ 

## Usage

```

usage: inbac [-h] [-a ASPECT_RATIO ASPECT_RATIO] [-r RESIZE RESIZE]

             [-s SELECTION_BOX_COLOR] [-w WINDOW_SIZE WINDOW_SIZE]

             [-f IMAGE_FORMAT] [-q IMAGE_QUALITY]

             [input_dir] [output_dir]

inbac - interactive batch cropper

Left Mouse Button                 - select part of image

Z                                 - save selection and go to the next picture

X                                 - save selection and stay on the same picture

C                                 - rotate current image by 90 degrees

Hold Left Shift or Left Ctrl      - drag selection

Right Arrow or Right Mouse Button - go to next picture

Left Arrow or Middle Mouse Button - go to previous picture

positional arguments:

  input_dir             input directory (defaults to current working

                        directory)

  output_dir            output directory (defaults to folder crops in input

                        directory)

optional arguments:

  -h, --help            show this help message and exit

  -a ASPECT_RATIO ASPECT_RATIO, --aspect_ratio ASPECT_RATIO ASPECT_RATIO

                        selection should have specified aspect ratio

  -r RESIZE RESIZE, --resize RESIZE RESIZE

                        cropped image will be resized to specified width and

                        height

  -s SELECTION_BOX_COLOR, --selection_box_color SELECTION_BOX_COLOR

                        color of the selection box (default is black)

  -w WINDOW_SIZE WINDOW_SIZE, --window_size WINDOW_SIZE WINDOW_SIZE

                        initial window size (default is 800x600)

  -f IMAGE_FORMAT, --image_format IMAGE_FORMAT

                        define the croped image format

  -q IMAGE_QUALITY, --image_quality IMAGE_QUALITY

                        define the croped image quality

 ```