<div align="center">

StudioWright

Google Flow and Google Flow Music, from your terminal and your AI agent.

Images, video clips and songs made in your own signed-in Chrome, on your own subscription.<br> No API keys. No cookie exports. No captcha solvers. No browser extension.

</div>

[!IMPORTANT] StudioWright is an independent, unofficial project. It is not affiliated with, endorsed or sponsored by Google. It drives Flow's and Flow Music's web pages in your browser and spends your credits. Read the disclaimer before you use it.

sw image "a lighthouse keeper with a teal coat, flat textured 2D" --aspect 16:9
sw video "he turns towards the sea" --start keeper.jpg --duration 4 --resolution 360p
sw music "moody indie folk, warm male vocal" --lyrics-file chorus.txt --length 1:00

Contents

• Showcase
• Why StudioWright
• Features
• Install
• Quick start
• Use it from AI agents
• Command reference
• Batch files
• Costs and safety
• How it works
• Troubleshooting
• Configuration
• Development
• Disclaimer

Showcase

Everything here was made with StudioWright, from one small batch file and two chat messages.

{"id": "keeper", "kind": "image", "prompt": "a lighthouse keeper with a teal coat, standing, flat textured 2D illustration", "refs": ["style.png"]}
{"id": "keeper-close", "kind": "image", "prompt": "close-up portrait of the same lighthouse keeper, flat textured 2D", "refs": ["keeper"]}
{"id": "keeper-clip", "kind": "video", "prompt": "the lighthouse keeper turns his head towards the sea, gentle wind", "start": "keeper", "resolution": "360p", "duration": 4}

<table> <tr> <td width="50%"><img src="docs/media/keeper.jpg" alt="A lighthouse keeper in a teal coat on a cliff at night"><br>_{<b>keeper</b> · Nano Banana 2.1 · style from a reference image · 22 s}</td> <td width="50%"><img src="docs/media/keeper-closeup.jpg" alt="Close-up of the same lighthouse keeper"><br>_{<b>keeper-close</b> · the same character, by referring to the first job · 21 s}</td> </tr> <tr> <td width="50%"><img src="docs/media/keeper-clip.gif" alt="The keeper turns towards the sea"><br>_{<b>keeper-clip</b> · Omni Flash, 4 s, start frame from the first job · 32 s · 4 credits}</td> <td width="50%"><a href="docs/media/beacon-in-the-dark.mp4"><img src="docs/media/beacon-cover.jpg" alt="Cover art of the song Beacon in the Dark: a lighthouse in a storm"></a><br>_{<b>Beacon in the Dark</b> · written and sung by the Flow Music Producer · 37 s · 5 credits<br><a href="docs/media/beacon-in-the-dark.mp4">▶ listen (MP4)</a> · <a href="docs/media/beacon-in-the-dark.mp3">MP3</a>}</td> </tr> </table>

The song took two chat turns:

sw music chat "Write a four-line chorus about a lighthouse keeper who waits for the ships."
sw music chat "Moody indie-folk please. Make the song now, about one minute long." --session <id from the first reply>

Why StudioWright

Most ways to automate Google's media models need one of these: a paid API key, cookies copied out of your browser, a captcha-solving service, an unpacked browser extension, or a third-party relay that holds your session. StudioWright needs none of them.

| | Paid model APIs | Cookie-based wrappers | Hosted relays | StudioWright | | --- | :---: | :---: | :---: | :---: | | Uses the credits of your Flow / Flow Music plan | ✗ | ✓ | ✓ | ✓ | | No API key or per-call billing | ✗ | ✓ | ✗ | ✓ | | Your session never leaves your machine | ✓ | ✗ | ✗ | ✓ | | No captcha solving or token forging | ✓ | ✗ | ? | ✓ | | Every option of the web app | partial | partial | partial | ✓ | | Images, video and music in one tool | ✗ | ✗ | partial | ✓ |

What makes it different:

• It acts like you. StudioWright types, clicks and chooses files in Flow's real pages, in a Chrome you signed in to yourself. It only reads the replies those pages receive, to learn ids and download links. It never forges, replays or alters a request.
• One package, three front doors. The same engine is a CLI (sw), an MCP server (sw mcp) and a Claude Code plugin.
• Built for real production. Price checks before you spend (--dry-run, --max-credits), resumable batch files that chain results, sized downloads (2K images, 1080p/4K clips), pacing across processes, and a cooldown when Google asks for a break.
• Fast on a warm tab. About 20 s for an image, 30-60 s for a clip, 40 s for a song.

Features

Images (Google Flow)

• Nano Banana 2.1 (default), Nano Banana Pro and Nano Banana 2 Lite.
• Aspect ratios 16:9, 4:3, 1:1, 3:4, 9:16; one to four images per call.
• Reference images from files or earlier results; each file is uploaded once per project and then reused by content.
• Downloads at Flow's own sizes: 1K (original), 2K (upscaled by Flow), 4K where the plan allows.

Video (Google Flow)

• Omni Flash (default), Veo 3.1 Lite, Fast and Quality.
• Text only, start frame, start and end frames, or ingredients (several reference images).
• Omni: 360p / 720p and 4, 6, 8 or 10 s. Aspect 16:9 or 9:16.
• Downloads at 720p, 1080p or 4K (upscaled by Flow), or as a GIF.
• --dry-run shows Flow's price without submitting; --max-credits refuses anything more expensive.

Music (Google Flow Music)

• Songs with your lyrics (any language) or instrumentals; Lyria 3.5 or Lyria 3 Pro; BPM, length (1:00-3:00), seed, title, and cover art from a file or a prompt.
• Edit existing songs: extend, cover in another style, replace a section, variation, trim.
• Stems: drums, bass, vocals and other, each as its own file.
• Downloads: WAV (48 kHz), M4A or MP3; vertical MP4 videos from Flow Music's templates.
• The Producer agent: chat with it to write lyrics, plan songs, remix your own audio or make AI music videos; songs it makes are saved automatically.
• Your own audio: upload a file and extend, cover or split it like any other song.

Automation

• CLI with --json output, an MCP server with 16 tools, and a Claude Code plugin with a skill.
• JSON Lines batch files that resume where they stopped and pass results between jobs.
• A job history (sw jobs) and a screenshot of the page whenever a job fails.

Install

Requirements: Python 3.12+, uv, Google Chrome, and a Google account with a Flow plan (images and video) and/or a Flow Music plan (music).

uv tool install git+https://github.com/umutkocak/studiowright
sw --version

This puts two identical commands on your PATH: studiowright and its short form sw.

<details> <summary>From a local checkout (for development)</summary>

git clone https://github.com/umutkocak/studiowright.git
cd studiowright
uv sync
uv tool install --python 3.13 -e .

</details>

Updating

• Plugin (MCP server and skill): claude plugin update studiowright@studiowright, or in Claude Code /plugin → Installed → studiowright → Update now; then /reload-plugins. Each plugin version runs the StudioWright release of the same version. To update automatically, turn it on once: /plugin → Marketplaces → studiowright → Enable auto-update.
• Command line: uv tool install --force git+https://github.com/umutkocak/studiowright@vX.Y.Z with the release you want (see Releases).

Quick start

1. Sign in once. Chrome opens on a profile that belongs to StudioWright only. Sign in to Google, open Flow once, then close the window.

sw auth login
sw auth login --url https://www.flowmusic.app/    # only if you will make music

Run sw stop first if StudioWright's Chrome is already running.

2. Make something.

sw image "a red fox in the snow, flat 2D" --aspect 1:1
sw video "slow push-in on a quiet harbour at dawn" --model veo-lite --dry-run   # price only
sw music "calm documentary underscore, soft piano, warm strings" --bpm 80 --length 1:30

Files land in Downloads/studiowright (change it with --out), and each command prints their paths. Add --json for ids, sizes, timings and credits.

3. Keep Chrome in the background. sw window hide moves the window off-screen. Never minimize it: a minimized Chrome stops rendering and Flow stalls.

Use it from AI agents

Every client below runs the same server: sw mcp (stdio). If a client cannot find sw, give it the full path (where sw on Windows, which sw elsewhere).

Generating takes real time (an image ~20 s, a clip up to a few minutes), so give the client a generous tool timeout where it has one.

Claude Code plugin (recommended)

The plugin adds the MCP server and a skill that teaches Claude the options, prices and safe habits.

claude plugin install studiowright --marketplace umutkocak/studiowright

or inside Claude Code:

/plugin marketplace add umutkocak/studiowright
/plugin install studiowright@studiowright

The plugin starts its own matching StudioWright release with uvx, so it needs only uv and Chrome; installing sw separately is for the command line.

Then just ask:

Make a 16:9 image of a lighthouse keeper, then a 4-second clip where he turns to the sea. Check the price first.

Write a one-minute instrumental bed for a documentary intro and give me the stems.

Claude Code (MCP server only)

claude mcp add --scope user studiowright -- sw mcp

For long video jobs, raise the tool timeout, e.g. MCP_TOOL_TIMEOUT=900000 in your environment.

<details> <summary><b>Claude Desktop</b></summary>

Settings → Developer → Edit Config, then add the server to claude_desktop_config.json (%APPDATA%\Claude\ on Windows, ~/Library/Application Support/Claude/ on macOS):

{
  "mcpServers": {
    "studiowright": { "command": "sw", "args": ["mcp"] }
  }
}

Quit Claude Desktop completely and start it again.

</details> <details> <summary><b>Cursor</b></summary>

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "studiowright": { "command": "sw", "args": ["mcp"] }
  }
}

</details> <details> <summary><b>VS Code (GitHub Copilot)</b></summary>

.vscode/mcp.json (note the servers key):

{
  "servers": {
    "studiowright": { "type": "stdio", "command": "sw", "args": ["mcp"] }
  }
}

For all workspaces, run MCP: Open User Configuration and add the same entry.

</details> <details> <summary><b>Codex CLI</b></summary>

codex mcp add studiowright -- sw mcp

or in ~/.codex/config.toml:

[mcp_servers.studiowright]
command = "sw"
args = ["mcp"]
tool_timeout_sec = 900

</details> <details> <summary><b>Gemini CLI</b></summary>

gemini mcp add -s user studiowright sw mcp

or in ~/.gemini/settings.json:

{
  "mcpServers": {
    "studiowright": { "command": "sw", "args": ["mcp"], "timeout": 900000 }
  }
}

</details>

MCP tools

| Tool | What it does | | --- | --- | | flow_generate_image | Images with any model, aspect, count, references and download size | | flow_generate_video | Clips with any model and mode, frames, references, size; dry_run, max_credits | | flow_upload / flow_download | Upload references once; fetch existing media again at any size | | `flow_list_media