Presets

Settings and profiles a team shares live in a .reelpreset file, which reels import on their first lines:

Text 
Import //demos/house.reelpreset
Launch ~/Projects/musicbox/build/App/Musicbox.app
Output //docs/media/musicbox.mp4
Text 
# house.reelpreset
Set Background //design/backdrop.png
Set Voice system:Samantha
Set Profiles github, web

Profile github
  Set GifColors 128

Profile docs extends web "Our docs site"
  Set VideoWidth 1440
  Set MaxSize 8MB
  • Import lines come first, before Launch or Open; comments may come before them. A reel may import several, and a preset may import presets, in order. One that comes back round is an error.
  • Set lines in a preset are defaults. They apply as the reel says what it records, before the reel's own settings, which override them. A profile overrides both.
  • Paths in a preset are relative to the preset. // starts at the git root; see Paths.
  • A preset holds Import, Set and Profile lines, and nothing that records. An error in one names the file and line.
Text 
Profile <name> [extends <profile>] ["what it is for"]
  Set <setting> <value>
  Set <setting> <value>

A profile is its line and the indented Set lines under it, in a preset or in a reel; it ends at the first line that isn't indented.

  • A built-in name amends that profile: Profile github and its settings add to github's own.
  • A new name starts from the profile it extends, or from nothing.
  • Names are lowercase letters, digits and dashes, and not an output type (mp4, mov, gif).
  • A profile can't set what is fixed when recording (FrameRate, Audio, Size, TypingSpeed, WaitTimeout, the Voice settings, Browser, Viewport), or choose profiles.

reel run reads every profile it is about to render before it records, so a bad value is refused first.