https://github.com/Xpycode/CropBatch

A macOS application to crop images in batch
https://github.com/Xpycode/CropBatch

batch-processing crop image-cropping image-processing macos macos-app screenshot swift swiftui utility

Last synced: 29 days ago
JSON representation

A macOS application to crop images in batch

• Host: GitHub
• URL: https://github.com/Xpycode/CropBatch
• Owner: Xpycode
• Created: 2025-12-27T16:16:45.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-01-12T11:51:04.000Z (about 1 month ago)
• Last Synced: 2026-01-12T18:55:44.941Z (about 1 month ago)
• Topics: batch-processing, crop, image-cropping, image-processing, macos, macos-app, screenshot, swift, swiftui, utility
• Language: Swift
• Size: 46.9 MB
• Stars: 16
• Watchers: 0
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-swift-macos-apps - CropBatch - commit/Xpycode/CropBatch?style=flat&label=" /> - A macOS application to crop images in batch. (Graphics / Text)

README

          
#  CropBatch

A macOS app for batch cropping images with configurable edge trimming.

![macOS](https://img.shields.io/badge/macOS-15.0+-blue.svg)

![Swift](https://img.shields.io/badge/Swift-6.0-orange.svg)

![License](https://img.shields.io/badge/license-MIT-green.svg)

![Version](https://img.shields.io/badge/version-1.2-brightgreen.svg)

[![Download](https://img.shields.io/badge/Download-v1.2-blue.svg)](https://github.com/Xpycode/CropBatch/releases/latest)

![Downloads](https://img.shields.io/github/downloads/Xpycode/CropBatch/total.svg)

## Screenshots

![Crop with Snap-to-Edge](03_Screenshots/mainWindow1-Crop-Snap.png)

![Blur Regions](03_Screenshots/mainWindow2-Blur.png)

![Watermark with Image](03_Screenshots/mainWindow3-watermarkPNG.png)

![Watermark with Text](03_Screenshots/mainWindow4-WatermarkTEXT.png)

## Features

- **Batch Processing** — Import multiple images via drag & drop or file browser

- **Visual Crop Editor** — Draggable handles on the image preview

- **Corner Radius** — Round corners with transparent cropping (PNG)

- **Blur Regions** — Blur sensitive areas with adjustable intensity

- **Watermarks** — Add image or text overlays with position, opacity, and styling

- **Snap-to-Edge** — Crop handles snap to detected UI element boundaries

- **Auto-Update** — Check for updates from the app menu

- **Scrubber Controls** — Drag the T/B/L/R labels to quickly adjust crop values

- **Aspect Ratio Guides** — 16:9, 4:3, 1:1, 9:16, 3:2, 21:9 overlays

- **Multiple Export Formats** — PNG, JPEG, HEIC, TIFF, WebP

- **Resize Options** — Exact size, max width/height, or percentage scaling

- **Flexible Naming** — Keep original names with suffix, or use patterns

- **File Size Estimation** — Preview output size for current file and batch

- **Keyboard Shortcuts** — Arrow keys for navigation, Shift+Arrow for crop adjustment

## Installation

1. Download `CropBatch-v1.2.dmg` from [Releases](https://github.com/Xpycode/CropBatch/releases/latest)

2. Open the DMG and drag CropBatch to Applications

3. Launch from Applications folder

## Usage

1. **Import** — Drop images onto the window or click Import Images

2. **Crop** — Drag handles on the preview, or scrub the T/B/L/R controls

3. **Configure** — Set format, naming, and resize options

4. **Export** — Click Export All to save cropped images

### Keyboard Shortcuts

| Shortcut | Action |

|----------|--------|

| ← → | Navigate images |

| ⇧ Arrow | Adjust crop |

| ⇧⌥ Arrow | Uncrop (expand) |

| ⇧⌃ Arrow | Adjust by 10px |

| ⌘1/2/3/4 | Zoom modes |

| S | Toggle snap-to-edge |

## Building from Source

Requires Xcode 16+ and macOS 15.0+

```bash

git clone https://github.com/Xpycode/CropBatch.git

cd CropBatch/01_Project

xcodebuild -scheme CropBatch -configuration Release

```

## License

MIT