> ## 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.
# Component reference
> Reference for the Astro Asciinema component props and theme-source values.
Import the named `Asciinema` component from the package root:
```astro Astro theme={null}
---
import { Asciinema } from "astro-asciinema";
---
```
```mdx MDX theme={null}
import { Asciinema } from "astro-asciinema"
```
## Props
URL of an asciicast or another recording format supported by Asciinema player.
Importing a local recording with `?url` produces a suitable value.
Serializable [Asciinema player
options](https://docs.asciinema.org/manual/player/options/). The component
passes these options to `AsciinemaPlayer.create` in the browser.
Source to watch for theme changes. When it changes, the component remounts the
player and preserves its playback time and playing state.
Accepted values:
* `"media"`: watch `(prefers-color-scheme: dark)`.
* `"class"`: watch the `dark` class on ``.
* `{ class: "name" }`: watch a custom class on ``.
* `"data-theme"`: watch the `data-theme` attribute on ``.
* `{ attribute: "name" }`: watch a custom attribute on ``.
* `false`: disable theme watching.
Class name applied to the rendered `` custom element.
## Example
```astro theme={null}
```
For custom light and dark palettes, see [Theme
watching](/guides/theme-watching).