What problem does it solve?
generate-personal-slides eliminates the time-consuming work of designing personal-photo slide creatives by automatically compositing your headline text over real catalog photos (and optional real-image insets) for TikTok and Instagram.
Core Features & Use Cases
- Real-photo slide rendering: Generates TikTok (1080×1920) and Instagram (1080×1350) slides using real backgrounds sourced from the project photo catalog.
- Optional real-image insets: Adds a real overlay inset (e.g., screenshots, repo cards, charts) using an absolute file path (no synthesized fake overlays).
- Auto photo selection by keywords: Matches
photo_keywords against media/images/tiktok/catalog.json to pick the best-fitting real photo.
- Platform-safe rules: Designed specifically for personal / POV / story content and not for LinkedIn (LinkedIn should use branded slides).
Quick Start
Use the build entrypoint to render slides from a slide spec JSON into a target output folder, then open the generated slide-NN.png files for TikTok and Instagram.