Skip to main content

Agent Audio Visualizer – Aura

A shader based audio visualization of a pulsing energy field.

Usage

This demo uses your device's microphone.

Code
'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.

Unicorn Studio

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 nameTypeDefault
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'>