Agent Audio Visualizer – Aura | LiveKit Documentation

Usage

This demo uses your device's microphone.

'use client';

    
import { useTheme } from 'next-themes';
import { useSession, useAgent } from '@livekit/components-react';
import { AgentSessionProvider } from '@/components/agents-ui/agent-session-provider';
import { AgentAudioVisualizerAura } from '@/components/agents-ui/agent-audio-visualizer-aura';

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

export function Demo() {
  const { resolvedTheme: theme } = useTheme();
  const { audioTrack, state } = useAgent();

  return (
    <AgentAudioVisualizerAura
      size="xl"
      color="#1FD5F9"
      colorShift={0.1}
      state={state}
      themeMode={theme}
      audioTrack={audioTrack}
    />
  );
}

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

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

Note

This component was designed in partnership with Unicorn Studio.

Unicorn Studio

Create jaw-dropping motion and interaction in minutes — no code. Embed with a few clicks.

Features

Visualize an agent's audio track
Customize the color and color shift of the aura
Select from five sizes: icon, sm, md, lg, and xl
Responds to agent state with unique animations
Light and dark mode support

Installation

pnpm dlx shadcn@latest add @agents-ui/agent-audio-visualizer-aura

Props

Prop name	Type	Default
size?	enum	lg
state?	enum	connecting
color?	`#${string}`	#1FD5F9
colorShift?	number	0.05
themeMode?	enum	–
audioTrack?	LocalAudioTrack \| RemoteAudioTrack \| TrackReferenceOrPlaceholder	–
ref?	Ref<HTMLDivElement>	–
...props?	ComponentProps<'div'>