# Terminal recordings

> Record and embed copyable terminal sessions with asciinema.


[asciinema](https://asciinema.org/) records terminal text and timing data rather
than video. Recordings stay sharp, remain copyable, and are usually much smaller
than screen video.

Install the recorder, run `asciinema rec theme-tour.cast`, and put the resulting
file in a page bundle or under `static/casts/`.

{{< asciinema src="/casts/theme-tour.cast" rows="8" cols="80" idleTimeLimit="1.5" >}}

```md
{{</* asciinema src="/casts/theme-tour.cast" rows="8" cols="80"
     idleTimeLimit="1.5" */>}}
```

`cols`, `rows`, `speed`, `idleTimeLimit`, `autoplay`, `loop`, `controls`, `fit`
and `theme` are supported. `theme="auto"` follows the site's light/dark mode;
pass an asciinema palette name to keep a recording on a fixed palette.

Data-driven layouts can use the same player without copying shortcode markup:

```go-html-template
{{ partial "asciinema.html" (dict
  "page" . "src" .Params.cast "id" "release-demo"
  "controls" "auto" "fit" "width" "theme" "auto") }}
```

Autoplay is off by default. The player version is pinned in `data/cdn.yaml`; see
[Dependencies](../dependencies.md) for CDN and self-hosting options.


---
Source: https://projectious-work.github.io/brand-theme-hugo-vanilla/docs/features/terminal-recordings/index.md