Every doc in the repo, indexed.

docs/EDITOR.md · ~5900 words

The Editor is Streamix Studio's post-production room: a full non-linear editor for the show you just recorded (or anything you import). It lives in the Editor tab and opens from Recordings → Edit. This document is the reference for its workspaces, panels, shortcuts, interchange formats and tiers. Everything listed…

• Workspaces & panels
• Timeline & trim
• Effects & color
• Audio
• Media management & productivity
• Replace / edit media (src/shared/editor/clips.ts)
• Shortcuts
• Time model
• Project file (.streamixedit)
• Media & playback
• Monitors
• Export
• Interchange (Pro / Business — editor.interchange)
• Tiers

docs/AUTO_REELS.md · ~2300 words

One button in the Editor toolbar turns a talking-head recording into a TikTok / Reels / Shorts edit: whisper word timings → jump cuts + filler removal → hook-first cold open → subject-tracked 9:16 reframe with alternating punch-ins → beat-synced FX → a style look → word-by-word captions → loudness-normalised…

• Trend brief — short-form editing, September 2026
• Pipeline
• Styles
• Model
• Using it
• Gating
• Verification

docs/AUTO_EDIT_YOUTUBE.md · ~3700 words

The long-form sibling of Auto Reels: one button turns a talking-head / product review recording into a finished 16:9 YouTube edit — the whole story top to bottom, tightened — with chapters, an intro lower third, section cards, phrase-level captions, −14 LUFS audio and web B-roll of the product being discussed,…

• How it works
• One flow: Polish (mograph pack) inside the build
• The edit language
• Product photos, AI generation and swapping (integration with the AI providers + replace-media work)
• B-roll sources and licences
• Verification
• Gating

docs/DELIVERABLES.md · ~1600 words

Deliverables turns one master timeline into every format a channel needs — YouTube 1080p / 4K, Shorts, Reels, TikTok, Instagram 4:5, Square, LinkedIn 1:1, custom w × h × fps — without duplicating a single clip. Each deliverable is a view on the master: reframe keyframes, caption re-layout, graphics re-anchoring and…

• Model
• Derivation (deriveDeliverable)
• Highlight picker (pickHighlight)
• Export (exportSpecForDeliverable → the existing queue)
• UI
• Public API (for the Auto Edit wizards)
• Verification

docs/MOGRAPH.md · ~2400 words

Polish makes a cut read like a channel: a motion-graphics family (intro · outro · YouTube end screen · kinetic chapter cards · lower thirds), a broadcast grade with skin protection, a transitions pack for talk ↔ B-roll and chapter boundaries, synthesised sound design, 2-frame A1 crossfades at every cut and music…

• Families
• Templates (GraphicDoc builders)
• Grades (skin-protected)
• Transitions pack
• Sound design
• applyPolish — one pure step
• Dialog
• Public API (for the Auto Edit wizards)
• Verification

docs/AI_PROVIDERS.md · ~2000 words

Streamix Studio can turn one photo of your product into B-roll stills and short cinematic clips, and write chapters / titles / description / tags from the transcript — using your own OpenAI and Higgsfield accounts. Nothing is proxied through Streamix servers; the keys never leave your Mac.

• 1. What we found (research, 21 Sep 2026)
• 2. Setup (what the user does)
• 3. What is real vs. guided vs. offline
• 4. Integration hook for the Auto Edit wizard
• 5. Security & reliability notes
• 6. Files

docs/LAYOUTS.md · ~1700 words

Everything a scene looks like — where the tiles go, what colours and fonts the overlays wear, and what shape the canvas is — is driven by four small, pure modules in src/shared/ and a thin layer of studio UI on top. All of it runs in Composited mode (Direct mode hands the camera to ffmpeg and has no compositor to…

• Layouts (src/shared/layouts.ts)
• Looks and the randomizer (src/shared/look.ts)
• Formats (src/shared/formats.ts)
• Show templates (src/shared/showTemplates.ts)
• Dev bridge and smoke

docs/MOTION.md · ~1400 words

Streamix Studio animates any layer with keyframes, stacks GPU effects per layer, and drives a digital PTZ "camera rig" on picture sources — the After-Effects trio, tuned for live use: every sampler is deterministic and cheap, everything is undoable, and nothing reaches the program output until you arm it.

• Where things live
• Keyframes
• FX stack
• Camera rig
• Virtual angles
• Actions & gating
• Verification

docs/OVERLAY_ASSETS.md · ~700 words

This document describes the Streamix Studio Blank Overlay Asset Pack bundled under src/renderer/public/overlays/blank/, and how Streamix turns those blanks into editable overlays / lower thirds.

• Kit inventory
• How blanks are meant to be filled
• Safe zones (normalized 0–1 inside the overlay box)
• Ready-made templates
• Bundled path
• Themes

docs/LIVE_EVENT.md · ~500 words

Dual-display workflow for Streamix Studio. Live Studio on the laptop stays the producer brain; the Live Event window puts a large program (and optional preview / multiview) surface on another monitor for stage or confidence viewing.

• Intended workflow
• Window contents
• Entitlements
• Related
• Settings
• Performance

docs/TELEPROMPTER.md · ~700 words

Broadcast-grade talent teleprompter built into Streamix Studio. The operator stays on the Live Studio display; a dedicated chrome-less window is meant to sit fullscreen on an Elgato Prompter (or any second monitor) in front of the camera.

• How to open
• Elgato display targeting
• Flip
• Script & clock
• Actions
• Entitlements
• Settings
• Script library

docs/COMMENTS.md · ~1200 words

Streamix merges live comments from every platform you stream to into one Comments dock tab and lets you pin any of them on screen as a designed card. This page covers what it does, what you need to set up on each platform, and how the pieces fit.

• What you get
• The on-screen card
• Setting up the platforms
• Filters and moderation
• Architecture (for contributors)

docs/MEDIA.md · ~1800 words

Ecamm-style media inside Streamix: video / audio / image playlists as scene sources, a soundboard with background music that ducks under your voice, and PDF slide decks that render straight into the compositor. Everything runs in Composited mode (Direct mode hands the camera to ffmpeg and has no compositor).

• Media playlist source (media.playback, every plan)
• PDF slides source (presentation, Creator+)
• Soundboard & music (soundboard, Creator+)
• Countdown / scheduled start (countdown, Creator+)
• Camera / source picture controls (source.color for colour, Creator+)
• Templates and one-click go live
• iPhone / iPad as a camera

docs/SHOWS.md · ~300 words

Live Studio productions are saved as show files — one bundle for scenes, overlays, layouts/looks, rundown, destinations (without secrets), audio chain prefs, and hotkeys.

• File menu
• What’s inside / outside
• Scene organisation
• Entitlement

docs/CONTROL_API.md · ~1400 words

Streamix runs a small control server inside the app's main process. It is what Bitfocus Companion, web tally pages, the remote producer view, OSC controllers, TSL tally receivers and your own scripts talk to. Everything it can do is the same action registry the hotkeys and the Stream Dock use…

• Transport and security
• HTTP
• WebSocket
• OSC (UDP)
• TSL UMD tally
• Bitfocus Companion
• Remote producer view
• Testing from a script

docs/TALLY.md · ~600 words

Three ways to get red/green out of Streamix: TSL UMD over the network (for tally boxes, multiviewers and camera UMDs), a web tally page any phone or browser can show, and tally borders in the multiview window. All three are derived from the same state: the scene on program is red, the scene on preview (studio mode)…

• TSL UMD (v3.1 and v5.0)
• Web tally page
• Multiview tally borders
• Deck keys
• Where the state comes from

docs/WINDOWS.md · ~1300 words

Windows 10 / 11 x64 is a first-class build target. This page covers how the Windows build differs from the macOS one, how to build and sign it, and — because the port was written and cross-built on a Mac — exactly what still has to be checked on real Windows hardware.

• What is different on Windows
• Building
• First run on a Windows machine — what to verify

docs/STREAMING_4K.md · ~2600 words

Streamix streams and records 3840×2160 (16:9) and 2160×3840 (9:16) at 30 / 60 fps end to end: 4K program canvas → compositor (with a render-scale governor) → GPU encoder (H.264 / HEVC / AV1) → RTMP(S) with Enhanced RTMP for HEVC / AV1, SRT (MPEG-TS), or a local MKV / MP4 file. Everything in this page was measured,…

• What the platforms accept (checked September 2026)
• Encoders — probed, not tabulated
• The pipeline
• Presets, bandwidth, pre-flight
• Stream health and the adaptive ladder
• Recording at 4K
• Verification (this Mac, /tmp/streamix-4k/)
• Known limits (honest list)

docs/AUDIO.md · ~1700 words

"I have a RODE mic and it should be really good, but it's picking up the air conditioner." Studio Voice is one broadcast voice chain that runs in three places from the same spec (src/shared/audio/voiceChain.ts):

• The chain
• Latency
• What is real and what is preview-only
• Measured on the user's recording (Sequence 1.mp4, 30–60 s, RØDE, HVAC)
• RODE tips (gain staging, distance, HVAC)
• Files

docs/COMMERCIAL.md · ~400 words

Desktop Electron app stays at the repo root. Commercial pieces are siblings:

• Run locally
• Stripe (test mode)
• Secrets never commit

docs/licensing.md · ~600 words

Streamix Studio talks to the Streamix commercial API from the main process only. Access and refresh tokens are encrypted with Electron safeStorage and never exposed to the renderer. The UI receives a public LicenseSnapshot (plan, entitlements, device list summary, grace flags).

• Environment
• API contract (desktop client)
• Offline grace & live lockout
• Feature gates
• Local development

docs/DEPLOY.md · ~2200 words

Licence API (server/, Fastify + Prisma) · marketing site + customer portal (web/, Next.js) · admin console (admin/, Next.js). This is the plan — nothing here has been executed against a public host yet. It needs the inputs listed in What I need from you.

• 1. Recommended layout
• 2. Environment variables
• 3. VPS bootstrap (once)
• 4. Database
• 5. Licence signing key ceremony
• 6. Stripe (live)
• 7. Deploy commands
• 8. Post-deploy checklist
• What I need from you

docs/WEBSITE.md · ~600 words

web/ is the Next.js 15 marketing site and customer portal; admin/ is the internal console; server/ is the licence API they both talk to. packages/shared holds the types and the one entitlement map (PLAN_ENTITLEMENTS) that the desktop app, the API and the site all read.

• Run everything locally
• Pages
• Verify
• Deploy

docs/BILLING.md · ~2100 words

Companion to PRICING.md (plans, prices, Sync to Stripe). This page is about the money path: checkout → webhook → licence, the Customer Portal, and how to go from test keys to live.

• Modes
• Purchase flow (guest first — the pricing page is the conversion path)
• The money path (reference)
• Current state — LIVE since 2026-09-22
• Flipping to live (done 2026-09-22 — kept as the runbook for a future key rotation or account move)

docs/DEPLOY_HOSTINGER.md · ~3200 words

Companion to DEPLOY.md (generic plan). This file is the as-built record for the production deployment done on 2026-09-22 into the cPanel account streamixstudio on the existing Hostinger VPS srv724514.hstgr.cloud (31.220.104.13), next to the 10 accounts already in production. Nothing outside that account was…

• 1. Findings that shaped the deployment
• 2. As-built layout (account streamixstudio, home /home/streamixstudio)
• 3. Verification (outside-in through nginx, before DNS, curl --resolve :80:31.220.104.13)
• 4. Credentials
• 5. Proof the other accounts were not touched (pre vs post snapshots on the VPS)
• 6. DNS — done at GoDaddy (Option B chosen, 2026-09-22)
• 7. After DNS flips — automatic (fired 2026-09-22 05:04 UTC; see §3a)
• 8. Day-2 operations
• 9. Rollback (new pieces only; never touches the other accounts)
• 10. Commits

docs/DESIGN.md · ~1900 words

The website (web/), the customer portal (web/src/app/portal) and the admin console (admin/) share one visual system, defined once in packages/shared/theme.css as --sx- custom properties plus a small set of .sx- component classes. Both Next apps import that file and map their Tailwind theme colours onto the tokens,…

• What the mockup depicts
• Tokens
• Component inventory (.sx-*)
• Motion
• Fonts
• Light grey theme
• Applying the look to a new page

docs/PRICING.md · ~900 words

Streamix Studio is a paid product with a 14-day trial. There is no Free tier.

• Changing a price
• Trial semantics
• Stripe
• Where the code lives

docs/SUPPORT.md · ~900 words

Customers open tickets in the portal (https://streamixstudio.com/portal/support); staff answer them in the admin console (https://admin.streamixstudio.com/support). Everything lives in the licence API and Postgres — the system works without e-mail; mail is a courtesy copy when a real adapter is configured.

• What a ticket is
• API (server/src/routes/portal.ts, routes/admin.ts, services/supportService.ts)
• E-mail
• In-app notification (portal)
• UI
• Tests

docs/UPDATES.md · ~800 words

How a released Streamix Studio finds, downloads and installs a newer version — and how to ship one.

• The feed
• Artifact names
• In the app (src/main/updater.ts, policy in src/shared/updates.ts)
• Shipping a release