First project
This page is a first session on a real Mac. If KnoxStudio is not installed yet, start with Install. SI generation is optional here — recording and export work without an account.
1. Start a project
File → New (⌘N), or New on the welcome card. The window title is an unsaved project until you Save (⌘S) as a .knoxstudio package.
Pin recents on the welcome card if you will reopen them. Missing files show a missing-file label — relink later from the timeline badge.
2. Put media on the timeline
Pick one:
Record a take
- Open File → Recording Setup (or the Recording setup button on the transport).
- Check permission chips, pick a display or window, turn on microphone if you will talk. Watch This take will include. System audio needs macOS 13+.
- Click Start Recording in that dialog (or Record on the transport after setup). A countdown ring appears (default 3 seconds; Esc cancels).
- Stop. Screen, camera, mic, and system audio land on separate tracks.
Details: Screen recording.
Import a file
Drag a video, audio, or image onto the window, or Add Media on the transport. Placement follows the timeline toolbar: @Head (playhead) or @Start.
| Kind | Extensions |
|---|---|
| Video | mp4, mov, m4v, avi, mkv, wmv, webm, flv, ts, mts, m2ts |
| Audio | mp3, aac, wav, m4a, ogg, flac |
| Image | png, jpg, jpeg, gif, bmp, webp, tiff, tif |
Documents (PDF, Word, and friends) go to Explorer as Markdown, not onto the timeline. Documents.
Talk to SI
Needs sign-in. Type Generate a video: in the SI Agent, or tap the empty-state chip. The job lands in ~/.knoxmedia/video/ and on the timeline when it finishes.
3. Play and trim
- Space play / pause. J K L shuttle.
- Drag a clip edge to trim. T splits at the playhead. W / E trim front / end to the playhead.
- Tab cycles Normal / Ripple / Insert / Overwrite. Ripple closes gaps when you delete.
Stay in Select (V) for this first cut. Full tool list: Edit modes and tools.
4. Export
- ⌘E or Export on the transport.
- Pick builtin Screen Tutorial 1080p (H.264, 1920×1080) or leave Whole project / MP4 H.264.
- Choose a folder that is not inside the
.knoxstudiopackage. - Wait for progress + ETA. The app verifies the file exists, has a duration, and has the expected streams.
Missing media blocks export — relink first. Details: Export formats.
5. Save
⌘S. The package includes project.json (compressed when large), media/, and related folders. Autosave keeps the last 5 snapshots under ~/.knoxmedia/projects/autosave/.
Press ? anytime for the shortcut overlay.
Next
- Workspace — panels, HUDs, Inspector tabs.
- Sign in — Manager, Writer, Editor, Voice Director.
- SI Agent chat — type, @, Confirm / Auto.