Repository navigation
Release v0.10.2
🎯 Koubou (工房) - The artisan workshop for App Store screenshots
Transform YAML into handcrafted App Store screenshots.
Koubou is your professional workshop where every screenshot
is carefully crafted with artisan quality.
工房 (koubou) means "artisan's workshop" in Japanese -
where masters create their finest work.
What's Changed
Fixed
- CRITICAL: Removed alpha channel from PNG screenshots - App Store does not accept images with alpha channels
- All generated PNG files now saved as RGB (without alpha) instead of RGBA
- Previously, PNG screenshots included an alpha channel that would cause App Store Connect to reject the images
Added
- Test to verify PNG files don't contain alpha channel
- Test to verify JPEG files are properly saved as RGB
Changed
- Unified image saving logic to always convert RGBA canvas to RGB before saving
- Both PNG and JPEG outputs now use the same RGB conversion process
Testing
- All 310 tests passing
- New tests specifically verify no alpha channel in generated images
- All linters passing (black, isort, flake8, mypy)
Installation
PyPI (Recommended)
pip install koubouHomebrew (macOS/Linux)
brew install bitomule/tap/koubouManual Download
Download the wheel or source distribution from the assets below.
Quick Start
kou create-config my-screenshots.yaml # Create sample config
kou generate my-screenshots.yaml # Generate screenshots
kou list-frames # List available device framesFeatures
- 🎨 100+ Device Frames: iPhone, iPad, Mac, Watch, and more
- 🌈 Professional Backgrounds: Linear, radial, conic gradients
- ✨ Rich Typography: Advanced text overlays with stroke, alignment
- 📱 YAML Configuration: Elegant, declarative screenshot definitions
- 🚀 Batch Processing: Generate multiple screenshots efficiently
Full Changelog: https://github.com/bitomule/koubou/commits/v0.10.2