--- title: Settings description: Every Set, its values and default, and whether it is fixed when recording. url: https://docs-v3-preview.elastic.dev/reel/reference/settings --- # Settings `Set `, in the reel's setup or a [preset](https://docs-v3-preview.elastic.dev/reel/outputs/presets). **Recording** settings are fixed when the take is made and can't differ by profile; changing one needs a new recording. **Render** settings change with `reel render`, and profiles and [conditions](https://docs-v3-preview.elastic.dev/reel/outputs/conditions) can set them. ## Recording | Setting | Values | Default | |--------------------|-------------------------------------------------------------------------------------------------|------------------------| | `FrameRate` | Frames a second captured, 1 to 120 | 60 | | `Audio` | `on`, `off`: record the app's sound | on | | `Size` | `x` in points: the app window's size | as it opens | | `Viewport` | `x` in points: a web page's or a code screen's size | 1280x800 | | `FontSize` | A code screen's or a terminal's text, 8 to 72 points | 18 | | `Columns`, `Rows` | A terminal's size in characters, 20 to 400 and 4 to 200 | 80, 24 | | `WorkingDirectory` | Where a terminal's shell starts | the reel's folder | | `Theme` | A Ghostty theme file for a terminal's colours | reel's | | `Title` | A terminal window's title | the folder — zsh | | `Redact` | `//`: covered with dots on a terminal's screen; one per line, as many as needed | none | | `Browser` | `webkit`, `chromium` or an `.app` path | webkit | | `TypingSpeed` | Pause after each typed character | 50ms | | `WaitTimeout` | How long `Wait` and `Click` look for an element | 10s | | `Voice` | `system`, `system:`, `voicebox:`; or ` `, a voice for `Say@` | system | | `VoiceServer` | voicebox's address | http://127.0.0.1:17493 | | `VoiceSeed` | voicebox's seed, 0 and up | 1 | | `VoiceLanguage` | voicebox's language, two letters | en | ## Overlays and narration | Setting | Values | Default | |--------------------------------------|--------------------------------------------------------------------------------------------------------------|-------------| | `KeyBadges` | `on`, `off` | on | | `ClickRipples` | `on`, `off` | on | | `Cursor` | `on`, `off`: the cursor in the video. Fixed when recording in an app reel, where the real cursor is recorded | on | | `Subtitles` | `on`, `off`: each `Say` as a caption | off | | `Ducking` | The app's sound under the voice, 0% to 100% | 25% | | `VoiceVolume` | 0% to 100% | 100% | | `AppVolume` | 0% to 100% | 100% | | `ZoomEasing` | `linear`, `ease-in`, `ease-out`, `ease-in-out`, `smooth`, `snap` | ease-in-out | | `ZoomDuration` | How long a zoom moves | 400ms | | `IntroBackground`, `OutroBackground` | `#rrggbb`, an image, or a video (its sound plays) | near-black | ## Framing and outputs | Setting | Values | Default | |------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|--------------| | `Background` | `#rrggbb`, an image or a video (looped, silent): frames every output | none | | `Padding` | Room around a framed recording, 0% to 30% of the canvas's shorter side | 6% | | `Layout` | In a reel of tracks: how they share the canvas, such as `(term / script) \| app`. See [Directing the tracks](/reel/demos/together#directing-the-tracks) | side by side | | `Shape` | `16:9`, `1:1`, `9:16` or `x`: every output with no shape of its own | none | | `Quality` | 1 to 100 | 65 | | `Codec` | `h264`, `hevc`, `prores` | h264 | | `VideoWidth` | 100 to 8000 pixels, never wider than the recording | full size | | `VideoFrameRate` | 1 to 120, never more than recorded | as recorded | | `MaxSize` | `10MB`, `500KB`, `1.5GB` | no limit | | `MaxLength` | A duration | no limit | | `Formats` | `mp4`, `mov`, `gif`, comma separated: write only these | all | | `GifWidth` | 100 to 4000 pixels | 800 | | `GifFrameRate` | 1 to 50 | 15 | | `GifColors` | 2 to 256 | 256 | | `Profiles` | Profile names, comma separated | none |