Record a walkthrough video

A screenshot shows where a step ended. A recording shows how it got there: the spinner that never stopped, the menu that opened twice. Record when the screenshot cannot show what a reviewer has to judge: animations, loading states, drag and drop, a flaky step, or a demo for a client.

Record a walk #

npx kaloko walk --record           # each step, from the previous screen to its capture
npx kaloko walk --record flow      # the whole walk per language, a chapter per step
npx kaloko walk --record failed    # only steps whose script or checks fail
npx kaloko walk --record --record-quality low --steps checkout

To record by default, set it in the scenario or in kaloko.config.yml:

capture:
  record: { mode: failed, quality: low, max_seconds: 45 }
nodes:
  - id: checkout
    record: true        # this step always; record: false never

Quality is low, medium (the default) or high. Recordings are much larger than screenshots, so do not record every walk.

Traces come with every web step #

Each walked web step keeps a trace: clicks and typing, network requests with status and timing, and console messages. It is small and on by default; --no-trace turns it off.

npx kaloko video list                    # what was recorded and traced, with sizes
npx kaloko video trace --step checkout   # the step's trace as a timeline in the terminal

On the canvas the step detail shows Video next to the screenshot, and the Technical tab shows the trace. Click a row and the video jumps there. Replay plays the flow recording chapter by chapter.

Make one video of the run #

npx kaloko video export --format mp4     # or webm, gif
npx kaloko video export --locale cs --steps cart,payment --lang cs --out checkout.mp4

The export puts the recordings in flow order with a title card before each step (its title and verdict). It is the file to send to a client or attach to a release note.

Tools you need #

Web and Electron recordings need nothing but Chrome. With ffmpeg installed you also get MP4 for Safari, app recordings (Android, the iOS Simulator, macOS) and the walkthrough export. npx kaloko video tools says what this machine has. Walks in WebKit and Firefox are neither recorded nor traced.

Sharing #

Recording works on every plan. kaloko share uploads recordings with the run on Business and Enterprise; on Free and Team they stay in the local preview, and the screenshots and traces are shared. Shared recordings are kept for 30 days (Enterprise sets its own period in Settings → Storage). A recording over 25 MB stays local: lower the quality or max_seconds.

Kaloko · latest · 2026-10-06