Documentation

How to use Studio

Studio has two modes. Use Edit existing to fix metadata on shorts already on your channel. Use Create new to generate branded shorts from scratch.

Open StudioBack to Dashboard

MODE A

Edit existing shorts

Fix titles, descriptions, and tags on shorts already on your channel. Uses AI suggestions from your latest diagnostic.

1

Open Studio in Edit mode

Studio opens in Edit mode by default. The grid shows every short from your most recent diagnostic scan.

2

Re-scan if needed

If you uploaded new shorts since the last scan, click Re-scan channel. It pulls fresh data and refreshes the grid.

TIP: Free tier is capped at 1 run per month; Creator gives 20; Pro is unlimited.

3

Pick a short

Click any thumbnail. The hook score and verdict (TOP_PERFORMER / SOLID / UNDERPERFORMING / DEAD) are shown on the card.

4

Edit metadata

The inline editor pre-fills title, description, and tags. AI-generated rewrites appear as one-click suggestions.

TIP: Click 'AI Generate' on the description to get a fresh draft based on the current title and tags.

5

First-time: enable write access

Save fails the first time with 'YouTube edit access not granted'. Click 'Enable Edit Access' to grant Google the write permission Studio needs.

6

Save to YouTube

The PUT request goes to YouTube's Data API. Changes appear on the live video within seconds.

MODE B

Create new shorts

Generate fully-branded slide-style shorts (or assemble from screen capture) and publish them as unlisted directly to your channel.

1

Pick a profile

Profile controls the visual brand (cards, colors, isometric logo). ShortVitals is preselected; switch via the profile dropdown.

2

Generate or paste a script

Either type a topic and let AI write the slide deck, or load a script from the active series queue.

TIP: Each slide is rendered as a 1080x1920 frame with monospace data styling that matches the diagnostic aesthetic.

3

Preview and pick audio mode

Three audio modes: TTS narration over slides, original audio (from a recording), or background music only.

4

Assemble video

FFmpeg WASM runs in your browser to combine slides, voice, and background music into a single MP4. No server cost.

TIP: Assembly takes 30–90s depending on slide count. The file stays local until you upload.

5

Upload to YouTube

Resumable upload to YouTube as Unlisted. Title and description are auto-generated; tweak before publishing.

REFERENCE

Permissions and limits

What Google scopes Studio needs and what your plan unlocks.

Read-only scopes (granted at sign-in)

youtube.readonly + yt-analytics.readonly. Used for scanning your channel and fetching analytics.

Write scope (granted on first save in Edit mode)

youtube (full). Used for editing video metadata and uploading new shorts. You must explicitly re-consent — Studio surfaces the button when needed.

Per-plan limits

  • Free: 1 diagnostic run, no Studio
  • Creator ($19/mo): 20 runs/mo, Studio with TTS-1
  • Pro ($49/mo): unlimited runs, Studio with TTS-1-HD, niche benchmarks

TROUBLESHOOTING

Common issues

If something looks off, start here before opening a ticket.

1

Grid shows fewer shorts than my channel

The grid reflects the latest diagnostic scan. Click Re-scan channel to refresh. If still mismatched, your channel may have unlisted/scheduled shorts the API doesn't return.

2

'Insufficient authentication scopes' on save

Click 'Enable Edit Access' next to the error. You'll re-consent through Google with the youtube write scope.

3

FFmpeg never finishes in Create mode

WASM assembly is memory-intensive. Close other browser tabs and retry. If it still fails, drop slide count below 12.

4

Upload to YouTube fails

Most often the same write-scope issue. Re-consent. If the error mentions quota, you've hit YouTube's daily upload limit (15 unverified, 50+ verified).