-
v0.14.0 Stable
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, andmax_heighton text content items — Koubou shrinks fromsizedown tomin_sizeuntil the wrapped text block fits withinmax_height. Ideal for multi-language screenshots where translation lengths vary. max_width,max_lines,max_height,min_sizefields onContentItemfor text contentmin_font_size,max_heightfields onTextOverlay- Validation:
min_sizerequires bothmax_widthandmax_height, and must be <=size
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.14.0
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
checksums.txt
0 downloads ·
2026-03-01 14:57:35 +03:00 · 184 B -
koubou-0.14.0-py3-none-any.whl
0 downloads ·
2026-03-01 14:57:41 +03:00 · 57 MiB -
koubou-0.14.0.tar.gz
0 downloads ·
2026-03-01 14:57:57 +03:00 · 57 MiB
- Text auto-sizing: Automatically find the largest font size that fits within a pixel height budget. Set
-
v0.13.0 Stable
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_familyfield to specify custom fonts (default: "Arial")
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.13.0
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
checksums.txt
0 downloads ·
2026-03-01 14:56:19 +03:00 · 184 B -
koubou-0.13.0-py3-none-any.whl
0 downloads ·
2026-03-01 14:56:25 +03:00 · 57 MiB -
koubou-0.13.0.tar.gz
0 downloads ·
2026-03-01 14:57:33 +03:00 · 57 MiB
- Text content items:
-
v0.12.0 Stable
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
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.12.0
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
checksums.txt
0 downloads ·
2026-03-01 14:55:04 +03:00 · 184 B -
koubou-0.12.0-py3-none-any.whl
0 downloads ·
2026-03-01 14:56:12 +03:00 · 57 MiB -
koubou-0.12.0.tar.gz
0 downloads ·
2026-03-01 14:56:18 +03:00 · 57 MiB
-
v0.11.1 Stable
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:
rotationnow applies to the entire framed asset (screen content + bezel) instead of being ignored whenframe: true
Changed
- Refactored
_apply_asset_frameto 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
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.11.1
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
checksums.txt
0 downloads ·
2026-03-01 14:54:49 +03:00 · 184 B -
koubou-0.11.1-py3-none-any.whl
0 downloads ·
2026-03-01 14:54:57 +03:00 · 57 MiB -
koubou-0.11.1.tar.gz
0 downloads ·
2026-03-01 14:55:02 +03:00 · 57 MiB
- Frame-aware image rotation:
-
v0.11.0 Stable
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
uploadcommand and all App Store Connect upload code - Removed
pyjwt,cryptography,httpxdependencies - Removed
responses,pytest-httpxdev 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 jsonflag forgenerate,list-sizes,list-framescommands--forceflag to overwrite existing files in--create-configAGENTS.mdwith agent-first CLI documentationMakefilewith standard development targets (format,lint,test,check).githooks/pre-commithook (activate withmake 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
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.11.0
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
checksums.txt
0 downloads ·
2026-03-01 14:53:34 +03:00 · 184 B -
koubou-0.11.0-py3-none-any.whl
0 downloads ·
2026-03-01 14:54:42 +03:00 · 57 MiB -
koubou-0.11.0.tar.gz
0 downloads ·
2026-03-01 14:54:48 +03:00 · 57 MiB
- BREAKING: Removed
mirror of
https://github.com/bitomule/Koubou.git
synced 2026-04-25 20:15:52 +03:00