PixelPruner is a user-friendly image cropping app for AI-generated art. It supports PNG, JPG, JPEG, and WEBP formats. Easily crop, preview, and manage images with interactive previews, thumbnail views, rotation tools, and customizable output folders. Streamline your workflow and achieve perfect crops every time with PixelPruner.
-
Multi-Format Support: Supports cropping images in PNG, JPG, JPEG, and WEBP formats. Crops are converted to PNG.
-
Interactive Crop Previews: Preview your crop selection in real-time with an interactive preview pane, before you make the crop.
-
Thumbnail View of Crops: View all your cropped images as thumbnails in a dedicated pane, making it easy to manage and review your work.
-
Rotation Tools: Easily rotate images to achieve the perfect orientation before cropping.
-
Multi-Crops: Make multiple crops from the same image. Multiple faces? No problem!
-
Source Gallery View: Cropping a lot of source images? View them in the gallery style Sources pane via
View > Sources Pane. Click on one in this pane to load it for cropping!
-
Custom Crop Sizes: Choose from preset dimensions or enter your own width and height.
-
Customizable Output Folder: Choose a custom folder to save your cropped images.
-
Default Directories: Set default input and output folders from the welcome screen or via
Settings > Set Default Paths. -
Zip Crops: Quickly zip all cropped images into a single archive for easy sharing, storage, or upload to the Civitai.com on-site LoRA Trainer
-
Undo Crop Actions: Made a mistake? Simply undo the last crop with the click of a button.
-
Keyboard Shortcuts: Navigate and manipulate images effortlessly with convenient WASD keyboard shortcuts.
-
Flexible Analysis: The PrunerIQ window includes a
Crops Onlycheckbox so you can analyze either just the cropped images or all images in a folder.
The built-in PrunerIQ analysis, accessed from the Tools menu, examines your cropped images and scores them using:
- Contrast – standard deviation of pixel intensities. Higher is better.
- Clarity – variance of the Laplacian; larger values indicate sharper images.
- Noise – difference between the image and a blurred copy. Lower numbers mean less noise.
- Aesthetic – placeholder score for future updates!
Each metric is also normalised into a 0‑100 percentage shown in the analysis table
(Contrast (%), Clarity (%), and Noise (%)). These give a quick visual cue
of how close the measurement is to the recommended threshold values. Each crop
receives a rating from Poor to Excellent based on the metrics. When
viewing the analysis window you can sort, filter ranges, and delete any
undesirable crops.
Head to the Releases and download the latest .exe version - pre-packaged with Python and ready to run (no installation required!)
Follow these steps to install and run PixelPruner on your local machine.
-
Python 3.x: Make sure you have Python 3.x installed on your system. You can download it from the official Python website.
-
Pillow: This library is required for image processing. You can install it with the
pippackage manager. -
Packaging: The packaging library is very useful for handling version numbers in Python projects. It allows you to reliably compare versions.
-
Clone the Repository
Clone the PixelPruner repository from GitHub to your local machine using the following command:
git clone https://github.com/theallyprompts/PixelPruner.git
-
Navigate to the cloned directory
-
Set Up a Virtual Environment (Optional but Recommended)
It is recommended to use a virtual environment to manage dependencies. Create and activate a virtual environment:
python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
-
Install Dependencies
Install the required dependencies using pip:
pip install pillow[webp] pip install tkinterdnd2 pip install packaging
If you're on Linux, you might need to install tkinter separately:
sudo apt-get install python3-tk
-
Running the Application
Run the PixelPruner application using the following command:
python PixelPruner.py
Select Folder: After launching the app, you can either drag a set of images into the main pane, or go to File > Set Input Folder, to select a folder of input images.
Select Crop Dimensions: From the dropdown in the top left, select the output dimensions for your crops.
Set an output directory (optional): Click File > Set Output Directory to choose a folder to save your crops. If no directory is chosen, PixelPruner will place crops beside the original images. Note: if you've dragged images into PixelPruner, you must manually set an output directory.
Crop and Manage Images: Use the interactive tools to crop, rotate, and manage your images. Cropped images can be previewed and saved to a custom output folder.
Analyze your Crops: Check your crops for clarity (blurryness), Noise, and Contrast using new PrunerIQ from the Tools menu!
Keyboard Shortcuts: Use keyboard shortcuts (W, S) to navigate through images and (A, D) to rotate them. Ctrl+Z will undo the last crop.
-
Add a toggle for advance-on-crop: Why on earth did I add an auto-advance on crop? What a huge mistake! The next update will add a toggle to choose whether to advance-on-crop or remain on the current image.Completed in v1.1.0 -
Input and Output Folder selection improvements - I want to be able to switch input directory mid cropping-session!Completed in v1.2.0 -
More Options for Input - Ability to drag a selection of images into the app for cropping, rather than select from a folder. That sounds useful.Completed in v2.0.0 -
A Better Menu - A proper file menu system.Added in v2.0.0 -
User Settings - The ability to save user preferences.Added in v3.0.0 -
Simple image editing - brightness, contrast, sharpness, etc. I want to be able to do as much as possible as easily as possible, without having to photoshop anything prior to upload to Civitai.
-
API Access to Civitai.com's LoRA Trainer: Upload zipped crops directly into Civitai.com's on-site LoRA trainer. The API for this doesn't exist yet, but maybe if I ask nicely...
TheAlly - Vibe coding ftw! If you've enjoyed PixelPruner, consider shooting me a tip! Thanks!