Skip to content

README.md

Latest commit

 

History

History
87 lines (68 loc) · 2.86 KB

README.md

File metadata and controls

87 lines (68 loc) · 2.86 KB

Crop Images Using Python

This Python program automates the process of cropping multiple images in a folder. It uses the Python Imaging Library (Pillow) to crop images based on specific criteria and provides several customizable options.

Features

  • Processes images in multiple formats: .jpg, .jpeg, .png.
  • Crops images into two parts:
    • The left part, excluding a margin on the left.
    • The right part, excluding a margin on the right.
  • Allows customization of the margin percentage for cropping.
  • Saves cropped images in a specified output folder.
  • Skips processing if cropped files already exist.
  • Provides detailed logging for processed files and errors.
  • Command-line arguments for flexibility:
    • Specify the input folder path (defaults to the current directory if not provided).
    • Specify the output folder path.
    • Set the margin percentage for cropping.

How It Works

  1. The program scans a folder for images containing the letter "a" in their filenames.
  2. For each image:
    • It calculates a margin based on the specified percentage.
    • Crops the image into two parts:
      • The left crop: From the margin to the middle of the image.
      • The right crop: From the middle of the image to the width minus the margin.
    • Saves the cropped images with new filenames:
      • Replaces "a" with "b" for the left crop.
      • Replaces "a" with "c" for the right crop.

Usage

  1. Install the required library:

    pip install pillow

  2. Run the script with the following command:

    python crop_images.py [folder_path] --output_folder <output_folder> --margin_percentage <margin_percentage>
    • [folder_path]: (Optional) Path to the folder containing images. Defaults to the current directory if not provided.
    • --output_folder: (Optional) Path to save cropped images. Default is output.
    • --margin_percentage: (Optional) Margin percentage for cropping. Default is 7.

  3. Examples:

    • Run the script in the current directory: 
      python crop_images.py
    • Specify a custom folder path: 
      python crop_images.py "C:\Users\DANISH LAPTOP\Desktop\Crop Multiple Images Using Python"
    • Specify a custom output folder: 
      python crop_images.py --output_folder "C:\Users\DANISH LAPTOP\Desktop\Cropped Images"
    • Change the margin percentage: 
      python crop_images.py --margin_percentage 10

Example Output

If the folder contains an image named examplea.jpg, the program will generate:

  • exampleb.jpg (left crop)
  • examplec.jpg (right crop)

Requirements

  • Python 3.x
  • Pillow library

Logging

The program logs all actions, including:

  • Files processed successfully.
  • Errors encountered during processing.

Logs are displayed in the terminal for easy debugging.

License

This project is licensed under the MIT License.