LiveKit docs › Components › Audio visualizers › AgentAudioVisualizerGrid

---

# Agent Audio Visualizer – Grid

> An audio visualization of a grid of particles.

## Usage

**[AgentAudioVisualizerGrid](https://docs.livekit.io/reference/components/agents-ui/component/agent-audio-visualizer-grid.md)** preview:

```tsx
'use client';

import { useSession, useAgent } from '@livekit/components-react';
import { AgentSessionProvider } from '@/components/agents-ui/agent-session-provider';
import { AgentAudioVisualizerGrid } from '@/components/agents-ui/agent-audio-visualizer-grid';

const TOKEN_SOURCE = TokenSource.endpoint('/api/token');

export function Demo() {
  const { audioTrack, state } = useAgent();

  return (
    <AgentAudioVisualizerGrid
      size={{size}}
      color={{color}}
      radius={{radius}}
      interval={{interval}}
      rowCount={{rowCount}}
      columnCount={{columnCount}}
      state={state}
      audioTrack={audioTrack}
    />
  );
}

export default function DemoWrapper({ session }) {
  const session = useSession(TOKEN_SOURCE);

  return (
    <AgentSessionProvider session={session}>
      <Demo />
    </AgentSessionProvider>
  );
}
```

## Features

- Visualize an agent's audio track
- Configure the speed, row and column size
- Select from five sizes: `icon`, `sm`, `md`, `lg`, and `xl`
- Responds to agent state with unique animations
- Apply a `transformer` function to generate custom CSS properties for each grid cell

## Installation

```bash
pnpm dlx shadcn@latest add @agents-ui/agent-audio-visualizer-grid

```

## Props

| Prop name | Type | Default |
| --------- | ---- | ------- |
| `radius?` | number | – |
| `interval?` | number | `100` |
| `rowCount?` | number | `5` |
| `columnCount?` | number | `5` |
| `className?` | string | – |
| `size?` | enum | `md` |
| `state?` | enum | `connecting` |
| `color?` | `#${string}` | – |
| `audioTrack?` | LocalAudioTrack | RemoteAudioTrack | TrackReferenceOrPlaceholder | – |
| `children?` | ReactNode | – |
| `ref?` | Ref<HTMLDivElement> | – |
| `...props?` | ComponentProps<'div'> | |

---

This document was rendered at 2026-06-07T11:35:12.251Z.
For the latest version of this document, see [https://docs.livekit.io/reference/components/agents-ui/component/agent-audio-visualizer-grid.md](https://docs.livekit.io/reference/components/agents-ui/component/agent-audio-visualizer-grid.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).