> ## Documentation Index
> Fetch the complete documentation index at: https://astro-asciinema.hedger.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Astro Asciinema

> Embed asciinema terminal recordings in Astro and MDX content.

`astro-asciinema` provides an Astro integration and component for embedding
terminal recordings with [asciinema
player](https://docs.asciinema.org/manual/player/).

* Use inside Astro or MDX content
* Import local `.cast` files as typed Vite assets
* Theme watching with media queries, classes, or attributes
* Preserve playback time and playing state while switching themes

<Columns cols={2}>
  <Card title="Installation" icon="package" href="/installation">
    Add asciinema to your Astro project
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Render your first recording
  </Card>

  <Card title="Theme watching" icon="sun-moon" href="/guides/theme-watching">
    Keep the player in sync with the theme of your site
  </Card>

  <Card title="Component reference" icon="braces" href="/reference/component">
    Reference for the `Asciinema` component
  </Card>
</Columns>