• 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

    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
  • v0.13.0 f39a338e10

    v0.13.0 Stable

    kerem released this 2026-02-14 17:37:01 +03:00 | 37 commits to main since this release

    📅 Originally published on GitHub: Sat, 14 Feb 2026 14:37:37 GMT
    🏷️ Git tag created: Sat, 14 Feb 2026 14:37:01 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 content items: font_family field to specify custom fonts (default: "Arial")

    Installation

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

    Downloads
  • v0.12.0 39a58dfa2a

    v0.12.0 Stable

    kerem released this 2026-02-14 16:06:25 +03:00 | 39 commits to main since this release

    📅 Originally published on GitHub: Sat, 14 Feb 2026 13:07:03 GMT
    🏷️ Git tag created: Sat, 14 Feb 2026 13:06:25 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

    • Highlight annotations: drop shadow, spotlight mode, blur background
    • Zoom callouts: drop shadow, source region indicator (border/dashed/fill), advanced connectors (straight/curved/facing with optional fill), zoom_level shorthand
    • Anti-aliased shape rendering via 2x supersampling
    • Shared renderer utilities (renderers/utils.py)
    • Example YAML and documentation for all new features

    Fixed

    • Zoom bubble no longer captures source indicator and connector lines in cropped content
    • Source indicator uses rectangular shape matching the crop region
    • Border-only highlights render outline shadow instead of filled shadow

    Testing

    • 317 tests passing

    Installation

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

    Downloads
  • v0.11.1 c25c284b6a

    v0.11.1 Stable

    kerem released this 2026-02-12 23:38:43 +03:00 | 48 commits to main since this release

    📅 Originally published on GitHub: Thu, 12 Feb 2026 20:39:22 GMT
    🏷️ Git tag created: Thu, 12 Feb 2026 20:38:43 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

    Fixed

    • Frame-aware image rotation: rotation now applies to the entire framed asset (screen content + bezel) instead of being ignored when frame: true

    Changed

    • Refactored _apply_asset_frame to compose framed assets in local coordinates before canvas placement, improving clarity and enabling rotation support

    Testing

    • 246 tests passing
    • Added regression test for framed image rotation

    Installation

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

    Downloads
  • v0.11.0 b832dfb745

    v0.11.0 Stable

    kerem released this 2026-02-11 22:09:38 +03:00 | 53 commits to main since this release

    📅 Originally published on GitHub: Wed, 11 Feb 2026 19:10:18 GMT
    🏷️ Git tag created: Wed, 11 Feb 2026 19:09:38 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

    Removed

    • BREAKING: Removed upload command and all App Store Connect upload code
    • Removed pyjwt, cryptography, httpx dependencies
    • Removed responses, pytest-httpx dev dependencies
    • Removed src/koubou/appstore/ module (auth, client, uploader)
    • Removed all upload-related tests
    • Removed interactive prompts (typer.confirm)
    • Removed single-letter flag abbreviations (-v, -n, -m)

    Added

    • --output json flag for generate, list-sizes, list-frames commands
    • --force flag to overwrite existing files in --create-config
    • AGENTS.md with agent-first CLI documentation
    • Makefile with standard development targets (format, lint, test, check)
    • .githooks/pre-commit hook (activate with make install-hooks)
    • JSON output sends structured data to stdout, progress/errors to stderr

    Changed

    • Upload workflow now recommends App Store Connect CLI (asc)
    • All CLI flags are explicit (no abbreviations) for unambiguous agent usage
    • Updated README and CLAUDE.md documentation

    Testing

    • 245 tests passing
    • All linters passing (black, isort, flake8, mypy)

    Installation

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

    Downloads