Skip to main content
Presets are named bundles of presentation defaults - theme, sound, cursor, and HUD settings - that you can apply with a single line. They set sensible defaults without locking you in: any setting a preset provides can be overridden in your config.

​
Using a Preset

Add the preset field to your config:
Presets never control output behavior - they don’t set steps, output, format, $schema, fps, or captureFps. They only set visual and audio presentation.

​
Stack Presets with Delivery Profiles

Use deliveryProfile for timing + readability defaults, then add preset for the visual layer:
In that stack, deliveryProfile sets the recording target (fps, captureFps, and readability-oriented sizing), while preset still only affects theme, sound, cursor, and HUD.

​
Built-in Presets

​
polished

The go-to preset for professional-looking recordings. Applies a warm Catppuccin color scheme with subtle click and keypress sound effects, a visible cursor, and HUD overlay.

​
minimal

Clean recordings with a Tokyo Night theme and cursor only. No sound, no HUD - just the terminal and a cursor.

​
demo

Similar to polished but with the Dracula theme. Good for quick demos where you want a familiar dark look with full audio-visual polish.

​
silent

The bare-bones preset: no cursor, no HUD, no sound. Useful when you want a clean terminal recording with no overlays, or as a baseline when you plan to customize everything yourself.

​
Overriding Preset Defaults

Preset values are defaults - your config overrides them. For example, the polished preset enables sound, but you can turn it off:
This keeps the Catppuccin theme, cursor, and HUD from polished but disables sound effects. You can also swap the theme while keeping everything else:

​
Presets in tuireel init

When you run tuireel init interactively (in a TTY), you’re prompted for a delivery profile first, then an optional preset:
The generated config always includes a delivery profile, and only includes preset when you opt into one. In non-interactive mode (piped input), Tuireel keeps the profile-first default and skips the optional preset prompt.