Skip to main content

​
Install Tuireel

Tuireel requires ffmpeg to be installed on your system for video encoding. Install it with brew install ffmpeg (macOS), apt install ffmpeg (Ubuntu), or download from ffmpeg.org.

​
Create Your First Recording

1

Initialize a config

Run tuireel init to scaffold a .tuireel.jsonc config file:
This creates a starter config with a simple example. Tuireel starts with a delivery profile (readable-1080p by default), then lets you optionally add a visual preset like polished or demo.
2

Edit your steps

Open .tuireel.jsonc and replace the steps with your own. Here’s a simple example:
3

Validate your config

Check your config for errors before recording:
This validates the schema, checks step types, and reports any issues.
4

Record

Run the recording:
Tuireel will spawn a PTY, execute each step, capture frames, and encode the final video.
5

View your output

Open the generated demo.mp4 to see your recording. That’s it - a polished terminal demo with no manual editing.

​
Add Polish with Presets

Want instant polish? Stack a visual preset on top of your delivery profile:
The polished preset applies the Catppuccin theme, enables cursor overlay, HUD, and sound effects - all in one line. The delivery profile separately controls readability defaults and timing: fps is the final output cadence, while captureFps is the raw terminal capture cadence behind it. Available presets: polished, minimal, demo, silent.

​
Next Steps

Config Reference

Full reference for all config fields and options.

Steps Reference

Every step type explained with examples.

Themes

Browse and customize terminal color themes.

Presets

Pre-configured bundles for common recording styles.