9:16
Reels
Vertical videos with kinetic type, voiceover, music and sound effects, a cover frame you choose, and a caption written for search.
New in 1.5 Stories, posts and carousels
Promo videos for your apps, directed by Claude Code.
Promo Studio reads your app's source code, writes a storyboard from your prompt and has Claude Code build every scene in Remotion. You approve it, and it posts the result to Instagram as a Reel, a story, a photo or a carousel.
- Free and open source
- Runs on your Mac
- No server, no account
- 10 languages
Every format
One prompt, wherever it goes on Instagram.
Choose a video or an image when you start, then pick where it's shared. Promo Studio sizes the design for it and posts through Instagram's official API, right away or on a schedule.
24h
Stories
Any video or picture as a story. A carousel goes out as one story per slide.
4:5
Photo posts
A single picture designed like a poster: portrait 4:5, square or 9:16, built in code and rendered as a sharp JPEG.
1/5
Carousels
Two to ten slides in one visual system: a hook, one idea per slide, a closing call to action.
Instagram fetches pictures from a public address. While one is published, Promo Studio opens a temporary Cloudflare link (cloudflared, no account) for those files only and closes it right after.
How it works
From your code to a finished post in four steps.
-
1
It reads your project
Point it at your app's project folder, whatever it's written in. Claude Code finds the app's features, brand colors and screenshots, and can capture new screens in the iOS Simulator.
-
2
You describe the video
Write what you want, or add your own images. Claude researches current facts on the web when needed and writes a scene-by-scene storyboard with its sources.
-
3
Claude codes it
After you approve the storyboard, Claude writes a custom Remotion composition, renders stills to check its own work and fixes what doesn't look right. Revise it in plain words.
-
4
Render and post
The Mac renders the video or image. Post it now, schedule it, or save it, then follow views and reach in the app.
Features
A whole studio in your menu bar.
Directed films
Every video is its own Remotion code: counters, phone shots, matchups, charts and transitions, from a kit made for short vertical video.
Real photos and logos
It finds real club crests and photos of real people on the web and cuts them out. With Codex on your ChatGPT plan it can change an expression or pose, at no extra cost.
Your own images
Add photos from your Mac or phone. Claude looks at them, builds the post around them and can place the cut-out subject over a new background.
Research with sources
Dates, line-ups and prices are checked with web search before they go on screen, and the sources stay with the post.
Voiceover and music
Optional Gemini text-to-speech fitted to each scene, a royalty-free beat and sound effects timed to the motion.
Ten languages
Videos, captions and the app itself in English, Türkçe, Deutsch, Español, Français, Italiano, Português, 日本語, 한국어 and 简体中文.
Errors you can act on
When a step fails, it says what happened in plain words and offers the fix as a button: try again, let Claude repair the code, reconnect an account.
From your iPhone
With Remote Code, create, approve and post from your phone while the Mac does the work.
Promo Templates
Videos made from code, and the skills that make new ones.
Promo Templates is the open-source template library of Promo Studio: physics loops, puzzles solved by real solvers, wordless machines, relaxing exercises and chat stories, all written as React components. Every kind of video is also a Claude Code skill: describe one, and Claude codes, checks and renders it.
- 15 skills, from /video-physics to /video-ideas for trend research
- Same seed, same video, in the Studio and in the render
- Promo Studio installs it, keeps it up to date and posts the videos
Yours
Your code, keys and videos stay on your Mac.
- Your own Claude Code. Promo Studio drives the claude CLI signed in with your account; there is no Promo Studio server or account.
- Secrets in the Keychain. Instagram tokens, the Meta app secret and the Gemini key live in your login keychain.
- No telemetry. Nothing is collected about you or what you make. The code is MIT-licensed on GitHub.
Get Promo Studio
For macOS 15 Sequoia or later. Install it with Homebrew, or download the signed app.
brew tap ardasnturk/promo-studio https://github.com/ardasnturk/promo-studio && brew install --cask promo-studio
It needs Claude Code (signed in) and Node.js 20 or later. On first launch, a checklist shows what's missing and installs the Remotion video engine. Gemini, Instagram, Codex and cloudflared are optional.
FAQ
Questions
What does it cost?
Promo Studio is free. It uses the Claude Code plan you already have. Voiceover uses your own Gemini API key, and photo edits use Codex on your ChatGPT plan; both are optional.
Which Instagram accounts can it post to?
Business and Creator accounts, through Instagram's official API, with Instagram Login (no Facebook Page needed) or Facebook Login. Meta may limit stories to Business accounts.
Do I need a Mac app project?
No. Projects make promo films about an app, but you can also make standalone videos and images from a prompt: news, stories, explainers, match previews.
Why does it need cloudflared?
Videos are uploaded directly, but Instagram downloads pictures from a web address. cloudflared opens a temporary, random trycloudflare.com link for just those files while they are published. It needs no Cloudflare account and nothing is stored online.
Can I use the videos elsewhere?
Yes. Save any video as an MP4 or any picture as a JPEG and post it to TikTok, YouTube Shorts or anywhere else.