SoftCropper Development for CanvasMagnet
Khaled Alam
Like this project
Posted Jul 14, 2025
Developed SoftCropper, a CLI tool for transforming images into square formats with annotations.
Likes
0
Views
0
SoftCropper
SoftCropper is a powerful CLI tool that transforms rectangular images into square, print-ready formats with aesthetic borders and customizable text annotations — built for precision and automation.
Actively used by CanvasMagnet for order prep and A4 layout automation.
📸 Example Results
Before ➡️ After Baby.webp (600×900)
Output (900×900)
Kid.jpg (1100×733)
Output (1100×1100)
A4:
🚀 Features
✅ Auto-square images with optional blurred/solid/gradient padding
🖼️ Add customizable rounded borders around photos
✍️ Annotate left/right/top/bottom with vertical or centered text (great for branding)
📄 Generate auto-arranged A4 collage pages from processed photos
📐 Resize final output by target size (e.g.
--size 5.5x5.5cm or --size 55x55mm)🧪 Includes CLI, Makefile, tests, and PyPI packaging
📦 Requirements
Python
>= 3.7opencv-pythonnumpy🔧 Installation
For local development:
⚙️ CLI Usage
Options
Flag Description
--mode One of: blur (default), solid, gradient --border Add rounded frame around photo --text Enable text mode (requires at least one --left/right/top/bottom) --left Vertical text on left side --right Vertical text on right side --top Centered text above the image --bottom Centered text below the image --size Resize output image (supports mm or cm, e.g. 55x55mm) --a4 Generate A4 page(s) from processed images✅ Testing
Or manually:
🛠️ Makefile Commands
📄 Changelog
See CHANGELOG.md
🤝 Contribution
Pull requests are welcome! Open an issue or fork and submit a PR if you'd like to improve SoftCropper.