Showreel Studio Help
Help · Recording

Record a film on your Mac

Record the take on your own Mac, for any app it can open, including one on localhost.

Recording opens your app in a browser on your Mac and acts out each line of the storyboard while the screen is captured. It works for any app your Mac can reach, including one running on localhost or on a private network. Nothing is recorded that the mask hides.

Before you start

In the app

  1. Open the film.
  2. Click Record in the pipeline across the top.
  3. Watch the log pane. It shows each part of the take as it records.
  4. When it finishes, click Build film in the top bar. See Build a film.

The pipeline steps are, in order: Storyboard (approved), Voice, Snapshot, Driver, Record, Build and Verify. Each is marked done, next or failed, and each is a button that runs it.

In the terminal

Record the film:

showreel record compose

Record signed in, with the sign-in you saved earlier:

showreel record compose --profile

Record against a different address this once:

showreel record compose --url https://qa.example.com

What happens during a take

  • If the film has steps and no driver, or the compiled driver is older than the storyboard, the driver is compiled first.
  • The app opens at the kit's frame size and waits until it is ready.
  • The driver works through the lines, holding each one for as long as its voice-over lasts.
  • A marker is recorded at the start of every line, so the build can cut the take to the voice exactly.
  • The mask is checked at every line and at the end. Anything unmasked is printed.

If a screen changed later

Record again with the voice kept, and rebuild in one go. In the app, click Recut under More stages on the Files panel. In the terminal:

showreel recut compose

If the take fails

The recording keeps what it reached and leaves a picture of the screen where it stopped. See Fix a failed take.

What next