https://github.com/hacktoolkit/gimp-utils
GIMP command-line utilities for batch image processing. Unix-philosophy tools using GIMP 3.0's headless mode.
https://github.com/hacktoolkit/gimp-utils
automation batch-processing command-line gimp gimp-scripts hacktoolkit image-processing script-fu
Last synced: about 2 hours ago
JSON representation
GIMP command-line utilities for batch image processing. Unix-philosophy tools using GIMP 3.0's headless mode.
- Host: GitHub
- URL: https://github.com/hacktoolkit/gimp-utils
- Owner: hacktoolkit
- License: mit
- Created: 2025-10-19T05:19:38.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-10-20T00:47:12.000Z (9 months ago)
- Last Synced: 2025-10-30T22:03:11.033Z (8 months ago)
- Topics: automation, batch-processing, command-line, gimp, gimp-scripts, hacktoolkit, image-processing, script-fu
- Language: Shell
- Homepage:
- Size: 20.6 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gimp-utils
GIMP utilities for batch image processing
Created by [@jontsai](https://github.com/jontsai) | Part of [Hacktoolkit](https://github.com/hacktoolkit)
## Overview
A collection of minimal, Unix-philosophy CLI utilities for automated image processing using GIMP's headless mode and Script-Fu.
Following the Unix philosophy:
- Each tool does one thing well
- Tools use stdin/stdout and can be composed
- Minimal arguments to memorize
- Clear help messages when invoked incorrectly
## Installation
Clone the repo and add scripts to your PATH, or run directly:
```bash
git clone https://github.com/hacktoolkit/gimp-utils.git
cd gimp-utils
```
Optional: Add to your PATH
```bash
export PATH="$PATH:$HOME/code/gimp-utils"
```
## Available Tools
### gimp-white-balance
Apply auto white balance (Colors > Auto > White Balance) to images in batch.
**Before & After Examples:**
*Example images courtesy of [@SkilletzCafe](https://github.com/SkilletzCafe)*
Before (Raw)
After (White Balanced)
**Usage:**
```bash
gimp-white-balance INPUT_DIR OUTPUT_DIR [PATTERN]
```
**Arguments:**
- `INPUT_DIR` - Directory containing source images
- `OUTPUT_DIR` - Directory where processed images will be saved (created if it doesn't exist)
- `PATTERN` - File pattern to match (default: `*.JPG`)
**Examples:**
```bash
# Process all JPG files
./gimp-white-balance ./photos ./processed
# Process PNG files
./gimp-white-balance ./photos ./processed "*.png"
# Process with absolute paths
./gimp-white-balance ~/Pictures/unprocessed ~/Pictures/processed
# Process all image types
./gimp-white-balance ./raw ./output "*.{jpg,JPG,png,PNG}"
```
**Output:**
The script will:
1. Find all matching files in INPUT_DIR
2. Show progress with checkmarks (✓ success, ✗ failure)
3. Save processed images to OUTPUT_DIR with the same filenames
## Requirements
- GIMP 3.0+ installed at `/Applications/GIMP.app` (macOS)
- Script-Fu support (built into GIMP)
- Bash shell
**Platform Support:**
- Currently supports macOS only
- Linux/Windows support coming soon (contributions welcome!)
**Installation Notes:**
- The script expects GIMP to be installed at the standard macOS location: `/Applications/GIMP.app`
- If GIMP is installed elsewhere, edit the script and update the path on line 69
## Notes
- **GIMP 3.0 Compatibility**: These scripts use GIMP 3.0's Script-Fu v3 API
- **Non-destructive**: Original files are never modified
- **Progress indicator**: Real-time feedback shows which files succeeded/failed
- **Error handling**: Continues processing remaining files even if one fails
## Technical Details
This tool uses GIMP's batch mode with Script-Fu v3 dialect to process images without GUI overhead. Each image is:
1. Loaded in non-interactive mode
2. Auto white balance applied using `gimp-drawable-levels-stretch`
3. Flattened to a single layer
4. Saved to the output directory
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Areas for contribution:
- Linux support (detecting GIMP installation paths)
- Windows support
- Additional image processing utilities
- Performance improvements
## Credits
Created and maintained by [@jontsai](https://github.com/jontsai)
Sponsored by [@hacktoolkit](https://github.com/hacktoolkit)
## License
MIT License - see [LICENSE](LICENSE) file for details