Skip to main content

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​

  1. Open File → Recording Setup (or the Recording setup button on the transport).
  2. 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+.
  3. Click Start Recording in that dialog (or Record on the transport after setup). A countdown ring appears (default 3 seconds; Esc cancels).
  4. 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.

KindExtensions
Videomp4, mov, m4v, avi, mkv, wmv, webm, flv, ts, mts, m2ts
Audiomp3, aac, wav, m4a, ogg, flac
Imagepng, 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​

  1. ⌘E or Export on the transport.
  2. Pick builtin Screen Tutorial 1080p (H.264, 1920×1080) or leave Whole project / MP4 H.264.
  3. Choose a folder that is not inside the .knoxstudio package.
  4. 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​