> ## Documentation Index
> Fetch the complete documentation index at: https://docs.responsivevoice.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Quick Start
## Basic Usage
Drop in the script tag or install from npm — both reach the same API:
**Browser bundle (CDN)**
```html
```
**npm**
```bash
npm install @responsivevoice/core
# or: pnpm add @responsivevoice/core / yarn add @responsivevoice/core
```
```typescript
import { getResponsiveVoice } from '@responsivevoice/core';
const rv = await getResponsiveVoice({ apiKey: 'YOUR_API_KEY' });
rv.speak('Hello, world!');
```
> [!NOTE]
> The examples below use the `rv` instance returned by `getResponsiveVoice()` (npm). With the browser bundle, call the same methods on the global `responsiveVoice`.
## Voice Selection
```typescript
// Get available voices
const voices = rv.getVoices();
console.log(voices);
// Speak with a specific voice
rv.speak('Hello', 'UK English Female');
rv.speak('Hello', 'US English Male');
rv.speak('Hallo', 'Deutsch Female');
```
## Playback Control
```typescript
// Pause speech
rv.pause();
// Resume speech
rv.resume();
// Cancel speech
rv.cancel();
// Check if speaking
if (rv.isPlaying()) {
console.log('Currently speaking');
}
```
## Events
```typescript
// Per-call callbacks — bound to this speak() call
rv.speak('Hello with events', 'UK English Female', {
onstart: () => console.log('Speech started'),
onend: () => console.log('Speech ended'),
onerror: (error) => console.error('Speech error:', error),
onboundary: (charIndex, name) =>
console.log('Word boundary:', charIndex, name),
});
// Global events — fire across every speak() call (pause/resume live here)
rv.addEventListener('OnPause', () => console.log('Speech paused'));
rv.addEventListener('OnResume', () => console.log('Speech resumed'));
```
> [!TIP]
> For more advanced usage, see the [Voice Selection](/guides/voice-selection/) and [Events](/guides/events/) guides.