Skip to main content

What is KnoxStudio

KnoxStudio is a native SI studio for macOS. You talk to it by text or realtime voice. Record your screen, generate video, images, music, and speech, write documents and screenplays, edit on a real timeline, and export what you made — all inside one fast app.

It is not only a video editor. The same SI Agent can compose a score, draft a brief from a dropped PDF, generate a still, continue a scene, or cut the timeline. Voice Director is that same agent, spoken.

This guide is for using KnoxStudio — from first launch through every studio surface. It is not the Knox.Chat HTTP API reference (that stays under Docs and API Reference), and it is not the KnoxCoder editor guide.

The pieces​

NameWhat it is
KnoxStudioThe macOS app (KnoxStudio.app). Recorder, NLE, canvas, Explorer, writers' room, and SI Agent.
SI AgentThe builtin studio agent. Manager (generate), Writer (documents), Editor (timeline), plus Director, Storyboard, Character Roles, and Voice Director.
Knox.Chat APIA separate cloud API. This app calls https://api.knoxstudio.ai after sign-in (stale api.knox.chat hosts rewrite on load). HTTP routes live in the Docs tab, not here.
KnoxCoderA separate desktop code editor with a builtin coding agent. Documented in the KnoxCoder tab.

KnoxStudio uses Knox.Chat after you Sign in with KnoxStudio. That does not make this tab the API docs.

What you can do​

On a typical session you:

  1. Open a .knoxstudio project, or start from Record / Import / Talk to SI.
  2. Capture a display, window, camera, microphone, and system audio — each on its own track.
  3. Ask the SI Agent to generate video, images, music, speech, or a document. Results land in ~/.knoxmedia and on the timeline.
  4. Cut on a real non-linear timeline: trim, split, ripple, insert, overwrite, annotate, mix.
  5. Write a screenplay in the same window, send it to Director Mode, and place a continuity-aware sequence.
  6. Export MP4, HEVC, ProRes, WebM, GIF, or audio-only.

You stay in charge. Confirm or Auto decides when generations and destructive edits run.

Data on this computer​

StoreWhat lives there
.knoxstudio packagesThe project you save: timeline, clips, markers, canvas, nests. Double-click in Finder to reopen.
~/.knoxmediaGenerated media, documents, screenplays, roles, chat SQLite, config.yaml, defaults.yaml. Mode 0700.
macOS KeychainThe minted KnoxStudio Desktop API token and OAuth refresh token. Never logged.

Recording, editing, writing, and export work offline. SI runs only after you sign in and send work out. Map: Data on disk.

Locales, license, platforms​

  • UI languages: English and Simplified Chinese only.
  • Platform: macOS 13.0 or later, Apple Silicon or Intel (Universal Binary).
  • Updates: a GitHub Release is a forced update — the app checks on launch and about every hour, downloads the signed DMG, and relaunches. Updates.

What is not in 1.7​

Call these out so the rest of the guide stays honest:

  • No coding agent. Writer treats source as text until a specialist ships.
  • No Windows or Linux app. KnoxStudio is macOS-only. KnoxCoder covers those platforms for coding.
  • No user-facing credits meter. Usage is billed on the KnoxStudio account; this app does not show a cost ledger.
  • No in-app focus mode. Cmd+Enter sends chat. Hide Explorer, the timeline, or the right panel from View if you want a quieter writing surface.
  • No direct PDF export of screenplays. Export HTML and use Print → Save as PDF.
  • No paste-an-API-key in SI Agent Configuration. Sign in with KnoxStudio is the only way to connect.

Next​

  1. Install KnoxStudio from GitHub Releases.
  2. Make a first project — record, import, or talk.
  3. Sign in when you want SI generation, Voice Director, or captions.