Skip to content

Open source · MIT · Linux, macOS, Windows

Show the tour.
Get the video.

Click through your app once, or tell your AI agent what to show: Tourwright's guide has it write the script for you. Then a real browser follows it with a guided focus, a voice and captions, and you get an MP4. When the UI changes, you render again. No re-recording, no script to write by hand.

Get started
examples/app.yaml click a step to jump
title: Facturero en un minutolanguage: es   # no voice: the most natural one on the machinemask: [email, phone, id]   # real data becomes inventedtheme: { frame: window, accent: "#3B82F6", titleBackground: aurora }steps:  - title: { text: Facturero en un minuto, say: "Te muestro Facturero en un minuto…" }  - focus: { target: { label: Usuario o correo }, say: "Primero, escribe tu {usuario o correo}.", step: 1/4, zoom: 1.35 }  - type: { target: { label: Usuario o correo }, text: "${secret:FACTURERO_USER}" }  - focus: { target: { label: Contraseña }, say: "Luego tu {contraseña}.", step: 2/4, zoom: 1.35 }  - type: { target: { label: Contraseña }, text: "${secret:FACTURERO_PASSWORD}" }  - focus: { target: { role: button, name: Ingresar }, say: "Y pulsa {Ingresar}.", pulse: true, click: true }  - focus: { target: { label: Código de verificación }, say: "Escribe el {código}…", step: 4/4 }  - type: { target: { label: Código de verificación }, text: "${totp:FACTURERO_TOTP}" }  - title: { text: Clientes, kicker: "Datos protegidos", background: page }  - say: "En Clientes ves a cada cliente con sus datos de contacto y su saldo."  - spotlight: { target: table }  - callout: { target: { text: "$ 1.250.000" }, text: "Datos inventados en pantalla" }  - focus: { target: { role: link, name: Facturas }, say: "Para subir una factura, abre {Facturas}.", click: true }  - title: { text: Facturas, kicker: "Subir archivos", background: page }  - say: "Elige el archivo de la factura y el cliente."  - upload: { target: { label: Archivo de la factura }, files: [factura.txt] }  - select: { target: { label: Cliente }, value: Luis Gómez }  - focus: { target: { role: button, name: Subir factura }, say: "Y pulsa {Subir factura}.", pulse: true, click: true }  - focus: { target: { text: guardada }, say: "La factura queda {guardada}.", zoom: 1.3 }  - focus: { target: { role: link, name: Reportes }, say: "En {Reportes}…", click: true }  - title: { text: Reportes, kicker: "Procesos largos", background: page }  - focus: { target: { role: button, name: Generar reporte }, pulse: true, click: true }  - wait: { text: Reporte listo, timeout: 20000 }   # cut from the video  - focus: { target: { text: Reporte listo }, say: "Cuando termina, aparece el {resultado}." }  - focus: { target: { role: status }, say: "Y los avisos llegan {en vivo}…", pulse: true }  - title: { text: Hecho con Tourwright, animation: zoom }
This video was rendered from the script next to it, by CI, with nobody at the keyboard: a 2FA login, invented data instead of real customers, an upload, a long job cut out, a live notice, in a studio frame with zoom and section cards. Play it and watch the script follow along.
Steps in the script
38
Length of the video
77 s
To render, from scratch
142 s
People at the keyboard
0

How it works

From showing your app once to a video that keeps itself current.

  1. 01

    Show it, or ask for it

    Click through your app once, or tell your AI agent what the video should show. The system asks for the script and writes it, following its own guide: you just read the narration.

    $ tourwright record https://app.facturero.co
      or: "make a 1-minute tour of checkout"
  2. 02

    Render

    A real Chromium follows the steps; loads and waits are cut; the voice, captions, chapters and poster are made.

    $ tourwright render tour.yaml
      52 s · 12 captions · tour.mp4
  3. 03

    Check in CI

    After every deploy, each script runs in seconds. A renamed button fails the build with the step and the fix.

    $ tourwright check videos/*.yaml
      step 7: cannot find "Save" → "Save draft"

What you get

Everything a good product video does, done by the script.

Guided focus

Everything dims but the element; a ring, a bubble and a gentle zoom land on the exact word being said.

It edits itself

Page loads, slow jobs and voice synthesis are cut out. Narration never overlaps; music ducks under the voice.

Real apps, real logins

2FA codes, saved sessions, uploads, live events. Credentials never sit in the script, and never show on screen.

Private data, invented

mask swaps emails, phones and IDs for consistent fake ones: film production safely.

A cast of voices

Several voices per video, speed and pitch per line, exact pauses, a pronunciation dictionary, sound presets.

From laptop to cluster

One binary on a Raspberry Pi, or an API with a Redis queue, workers and S3. Linux, macOS and Windows.

Why a script

A recording is out of date the day the UI changes. A script isn't.

WhatScreen recorderDemo SaaSTourwright
After a UI changerecord it againrebuild the demotourwright render
Knows a video went stalenonocheck in CI: the step and the fix
Narrationyour voice, retakesnone, or extradozens of voices, offline or online
The same tour for 50 customers50 recordings50 demosone script with {{variables}}
Personal data on screenedit it outedit it outreplaced with invented data
An AI agent can make onenonoMCP server and Claude Code plugin
Where it livesa vendor’s clouda vendor’s cloudyour repo and your servers, MIT

For AI agents and pipelines

Ask your agent for a video. Let CI keep it honest.

Claude Code plugin

The MCP server plus a skill that writes the script, dry-runs it against your app, fixes the targets and renders.

# in Claude Code
/plugin marketplace add CXmiloxx/tourwright
/plugin install tourwright@tourwright

> make a one-minute onboarding video of
  http://localhost:3000 for new admins

Any other MCP client: npx -y tourwright mcp

GitHub Action

Render the tours on every release, or fail the build when a deploy broke one. The job summary shows the fix.

- uses: CXmiloxx/tourwright@v2
  with:
    scripts: videos/*.yaml
    command: check      # or render
  env:
    TOURWRIGHT_SECRET_APP_PASSWORD: ${{ secrets.APP_PASSWORD }}

Also: an HTTP API with a job queue and webhooks, Docker, Kubernetes.

Voices

Pick who narrates. Offline or online.

Plus any OpenAI-compatible TTS server (OpenAI, Kokoro, LocalAI) or your own command. Speed, pitch and volume per line, on every engine.

Your next tutorial is a text file.