Skip to content

Release v0.10.2

Choose a tag to compare

@github-actions github-actions released this 01 Nov 08:41
· 73 commits to main since this release

🎯 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 koubou

Homebrew (macOS/Linux)

brew install bitomule/tap/koubou

Manual 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 frames

Features

  • 🎨 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