starred/Koubou
1
0
Fork 0
mirror of https://github.com/bitomule/Koubou.git synced 2026-04-25 20:15:52 +03:00
Code Issues 1 Projects Releases 5 Packages Wiki Activity
5 releases 62 tags
  • v0.14.0 bf10aa10ef

    v0.14.0 Stable

    kerem released this 2026-02-25 12:26:13 +03:00 | 35 commits to main since this release

    📅 Originally published on GitHub: Wed, 25 Feb 2026 09:26:51 GMT
    🏷️ Git tag created: Wed, 25 Feb 2026 09:26:13 GMT

    🎯 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

    Added

    • Text auto-sizing: Automatically find the largest font size that fits within a pixel height budget. Set min_size, max_width, and max_height on text content items — Koubou shrinks from size down to min_size until the wrapped text block fits within max_height. Ideal for multi-language screenshots where translation lengths vary.
    • max_width, max_lines, max_height, min_size fields on ContentItem for text content
    • min_font_size, max_height fields on TextOverlay
    • Validation: min_size requires both max_width and max_height, and must be <= size

    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.14.0

    Downloads