Guide

Record a talk

Record your slides and voice from the presenter view, with an optional camera picture. TalkWeaver saves the slides, the voice and the camera as separate layers, and keeps a Run: the record of that one delivery of your talk.

Start a recording

  1. Open your talk in the presenter view.
  2. In the recording controls, choose Slides and voice to record the slides and your voice, or Slides, voice and camera to record the camera as well.
  3. Choose your microphone with Microphone. You can also set it in Settings › Recording › Microphone. TalkWeaver remembers the choice on this Mac.
  4. Choose Record, or press ⇧R. The first time you record, and after you change the microphone or camera, the Check camera and microphone dialogue opens. At other times the countdown starts at once.
  5. If the dialogue opens, check the microphone name and level. If you chose a camera, check its preview and select the camera you want. Then choose Use these devices.
  6. A countdown shows 3, 2, 1 on a dark disc in the middle of the presenter view, then recording starts. The countdown is not recorded.
  7. Present your talk as usual.

The level and name of the microphone beside Record show while the microphone preview is on.

The presenter’s status bar before recording: Not recording, the Record button, the Slides and voice choice and the Microphone button.
Choose what to capture beside Record in the presenter’s status bar.
Check camera and microphone showing a fake camera test pattern, the test microphone, its level meter, the Camera choice and Use these devices.
On the first recording, or after a device change, check the camera and microphone. The camera here is a test pattern.
The number 3 in white on a dark round disc over a white slide.
The countdown sits on a dark disc, so it shows over a white slide.

What the layers contain

Each layer is a separate recording. The slides layer records the talk’s slides only, not your desktop or any other application. The voice layer records the microphone you chose. The camera layer, if you chose a camera, records that camera as its own layer, so you can leave its picture out of the finished video.

Pause, stop and save

While recording, choose Pause recording to pause and Resume recording to continue. To throw away the recording in progress and begin again, choose Start again, the circular arrow at the end of the recording controls, then Discard and start again; Runs you saved earlier are kept. Hold the pointer over any control to see its name. On a narrow screen, Start again and Microphone may leave the bar while you record; the presenter’s command palette still has Start again… and Choose microphone… under Recording.

  1. When you finish, choose Stop and save recording.
  2. If the recording is shorter than 20 seconds, TalkWeaver asks Short recording — keep it? Choose Keep to save it or Discard to delete it. You can change the length in Settings › Recording › Advanced recording settings, under Discard runs shorter than.
  3. To edit the recording now, choose Edit video on the Saved to History note that appears after saving. It opens Studio on this Run.
  4. To edit it later, choose Tools › TalkWeaver Studio…, open the saved Run and choose Edit video.
The presenter’s status bar while recording: REC and the running clock, then the Microphone, Pause, Stop and Start again buttons as icons.
While recording, the controls are Microphone, Pause recording, Stop and save recording and Start again.

What is saved where

A Run holds the slide changes and recording details of one delivery. The Run, its transcript and its edit file are saved in your vault. The recorded voice, slides and camera files are saved in TalkWeaver’s app-data folder, outside the vault. When you move or back up a recorded talk, keep both the vault and these recording files.

Saved itemLocation
Run recordIn your vault: _PRESENTATIONS/<talk>/<Run ID>.json.
VoiceIn TalkWeaver’s app-data folder: recordings/<Run ID>.webm. Additional segments are saved with numbered names.
Slides and cameraIn app data: recordings/<Run ID>/, with slides.webm, optional camera.webm, and capture.json.
Transcript and editsSeparate files beside the Run: <Run ID>.transcript.json and <Run ID>.edits.json.

To open the recording folder:

  1. Open Settings › Recording.
  2. Beside Recordings on this Mac, choose Show in Finder.

A Run ID looks like sess-20260706-225356-p. On macOS the app-data folder is normally ~/Library/Application Support/talk-weaver. If a Run cannot be saved to its vault, TalkWeaver can keep it in app data instead, and the message shown after saving says so.

Permissions and problems

When you use the microphone or camera, macOS may ask for access. If access is denied, allow TalkWeaver in System Settings › Privacy & Security › Microphone or Camera, then try again. The slides layer is captured inside TalkWeaver, so there is no desktop screen picker.

  • If the microphone is lost, a warning explains what stopped and offers another connected microphone. The Run records the gap. Changing microphone does not recover voice that was not recorded.
  • If saving fails, keep the presenter open, check disk space and try again.
  • If a picture layer fails, the voice you captured is still saved.

Known limits

Recording does not capture your whole screen. When you reach the last slide, the notice Last slide. Save this run to History? stays until you save or dismiss it, also if you go back to an earlier slide. Recording has not been checked by hand on Windows.