expo-speech-transcriber

On-device speech transcription for Expo apps. Supports iOS (Apple Speech framework) and Android (SpeechRecognizer API).

Features

- 🎯 On-device transcription - Works offline, privacy-focused
- 📱 Cross-platform - iOS 13+ and Android 13+ (API 33)
- 🚀 Multiple APIs - SFSpeechRecognizer (iOS 13+), SpeechAnalyzer (iOS 26+), and Android SpeechRecognizer
- 📦 Easy integration - Auto-configures permissions
- 🔒 Secure - All processing happens on device
- ⚡ Realtime transcription - Get live speech-to-text updates with built-in audio capture
- 📁 File transcription - Transcribe pre-recorded audio files
- 🎤 Buffer-based transcription - Stream audio buffers from external sources for real-time transcription

Installation

``bash
npx expo install expo-speech-transcriber expo-audio
`

Add the plugin to your app.json:

`json
{
"expo": {
"plugins": ["expo-audio", "expo-speech-transcriber"]
}
}
`

$3

Apple requires a clear purpose string for speech recognition and microphone permissions. Without it, your app may be rejected during App Store review. Provide a descriptive message explaining why your app needs access.

`json
{
"expo": {
"plugins": [
"expo-audio",
[
"expo-speech-transcriber",
{
"speechRecognitionPermission": "We need speech recognition to transcribe your recordings",
"microphonePermission": "We need microphone access to record audio for transcription"
}
]
]
}
}
`

For more details, see Apple's guidelines on requesting access to protected resources.

> Note for Android: The plugin automatically adds the RECORD_AUDIO permission to your Android manifest. No additional configuration is required.

Usage

$3

Start transcribing speech in real-time. This does not require expo-audio.

`typescript
import { Platform } from "react-native";
import * as SpeechTranscriber from "expo-speech-transcriber";

// Request permissions
// Note: requestPermissions() is only needed on iOS
if (Platform.OS === "ios") {
const speechPermission = await SpeechTranscriber.requestPermissions();
if (speechPermission !== "authorized") {
console.log("Speech permission denied");
return;
}
}

const micPermission = await SpeechTranscriber.requestMicrophonePermissions();
if (micPermission !== "granted") {
console.log("Microphone permission denied");
return;
}

// Use the hook for realtime updates
const { text, isFinal, error, isRecording } =
SpeechTranscriber.useRealTimeTranscription();

// Start transcription
await SpeechTranscriber.recordRealTimeAndTranscribe();

// Stop when done
SpeechTranscriber.stopListening();
`
NOTE: See RecordRealTimeAndTrancribe for an example on how to use Real Time transcription on android.

$3

Transcribe pre-recorded audio files. Our library handles transcription but not recording—use expo-audio to record audio (see expo-audio documentation), or implement your own recording logic with microphone access via requestMicrophonePermissions().

`typescript
import * as SpeechTranscriber from "expo-speech-transcriber";
import { useAudioRecorder, RecordingPresets } from "expo-audio";

// Record audio with expo-audio
const audioRecorder = useAudioRecorder(RecordingPresets.HIGH_QUALITY);
await audioRecorder.prepareToRecordAsync();
audioRecorder.record();
// ... user speaks ...
await audioRecorder.stop();
const audioUri = audioRecorder.uri;

// Transcribe with SFSpeechRecognizer (preferred)
const text = await SpeechTranscriber.transcribeAudioWithSFRecognizer(audioUri);
console.log("Transcription:", text);

// Or with SpeechAnalyzer if available
if (SpeechTranscriber.isAnalyzerAvailable()) {
const text = await SpeechTranscriber.transcribeAudioWithAnalyzer(audioUri);
console.log("Transcription:", text);
}
`

For custom recording without expo-audio:

`typescript
// Request microphone permission for your custom recording implementation
const micPermission = await SpeechTranscriber.requestMicrophonePermissions();
// Implement your own audio recording logic here to save a file
// Then transcribe the resulting audio file URI
`

$3

Stream audio buffers directly to the transcriber for real-time processing. This is ideal for integrating with audio processing libraries like react-native-audio-api.

`typescript
import * as SpeechTranscriber from "expo-speech-transcriber";
import { AudioManager, AudioRecorder } from "react-native-audio-api";

// Set up audio recorder
const recorder = new AudioRecorder({
sampleRate: 16000,
bufferLengthInSamples: 1600,
});

AudioManager.setAudioSessionOptions({
iosCategory: "playAndRecord",
iosMode: "spokenAudio",
iosOptions: ["allowBluetooth", "defaultToSpeaker"],
});

// Request permissions
const speechPermission = await SpeechTranscriber.requestPermissions();
const micPermission = await AudioManager.requestRecordingPermissions();

// Stream audio buffers to transcriber
recorder.onAudioReady(({ buffer }) => {
const channelData = buffer.getChannelData(0);
SpeechTranscriber.realtimeBufferTranscribe(
channelData, // Float32Array or number[]
16000, // sample rate
);
});

// Use the hook to get transcription updates
const { text, isFinal, error } = SpeechTranscriber.useRealTimeTranscription();

// Start streaming
recorder.start();

// Stop when done
recorder.stop();
SpeechTranscriber.stopBufferTranscription();
`

See the BufferTranscriptionExample for a complete implementation.

API Reference

$3

Platform: iOS only. On Android, speech recognition permission is handled through requestMicrophonePermissions().

Returns: Promise - One of: 'authorized', 'denied', 'restricted', or 'notDetermined'

Example:

`typescript
import { Platform } from "react-native";

if (Platform.OS === "ios") {
const status = await SpeechTranscriber.requestPermissions();
}
`

$3

Request microphone permission.

Returns: Promise - One of: 'granted' or 'denied'

Example:

`typescript
const status = await SpeechTranscriber.requestMicrophonePermissions();
`

$3

Start real-time speech transcription. Listen for events via useRealTimeTranscription hook.

Returns: Promise

Example:

`typescript
await SpeechTranscriber.recordRealTimeAndTranscribe();
`

$3

Stop real-time transcription.

Returns: void

Example:

`typescript
SpeechTranscriber.stopListening();
`

$3

Check if real-time transcription is currently recording.

Returns: boolean

Example:

`typescript
const recording = SpeechTranscriber.isRecording();
`

$3

Transcribe audio from a pre-recorded file using SFSpeechRecognizer. I prefer this API for its reliability.

Platform: iOS only

Requires: iOS 13+, pre-recorded audio file URI (record with expo-audio or your own implementation)

Returns: Promise - Transcribed text

Example:

`typescript
const transcription = await SpeechTranscriber.transcribeAudioWithSFRecognizer(
"file://path/to/audio.m4a"
);
`

$3

Transcribe audio from a pre-recorded file using SpeechAnalyzer.

Platform: iOS only

Requires: iOS 26+, pre-recorded audio file URI (record with expo-audio or your own implementation)

Returns: Promise - Transcribed text

Example:

`typescript
const transcription = await SpeechTranscriber.transcribeAudioWithAnalyzer(
"file://path/to/audio.m4a"
);
`

$3

Check if SpeechAnalyzer API is available.

Platform: iOS only. Always returns false on Android.

Returns: boolean - true if iOS 26+, false otherwise

Example:

`typescript
if (SpeechTranscriber.isAnalyzerAvailable()) {
// Use SpeechAnalyzer
}
`

$3

React hook for real-time transcription state.

Returns: { text: string, isFinal: boolean, error: string | null, isRecording: boolean }

Example:

`typescript
const { text, isFinal, error, isRecording } =
SpeechTranscriber.useRealTimeTranscription();
`

$3

Stream audio buffers for real-time transcription. Ideal for integration with audio processing libraries.

Parameters:

- buffer: Float32Array | number[] - Audio samples
- sampleRate: number - Sample rate in Hz (e.g., 16000)

NOTE We currently support transcription for mono audio only. Natively, the channel is set to 1.

Returns: Promise

Example:

`typescript
const audioBuffer = new Float32Array([...]);
await SpeechTranscriber.realtimeBufferTranscribe(audioBuffer, 16000);
`

$3

Stop buffer-based transcription and clean up resources.

Returns: void

Example:

`typescript
SpeechTranscriber.stopBufferTranscription();
`

Example

See the example app for a complete implementation demonstrating all APIs.

Requirements

$3

- English only - Currently hardcoded to en_US locale
- File size - Best for short recordings (< 1 minute)
- Recording not included - Real-time transcription captures audio internally; file transcription requires pre-recorded audio files (use expo-audio or implement your own recording with requestMicrophonePermissions())
- Android file transcription - File-based transcription (transcribeAudioWithSFRecognizer, transcribeAudioWithAnalyzer`) is iOS only. Android supports real-time transcription
- Android API level - Android requires API level 33+ (Android 13)

License

MIT

Contributing

Contributions welcome! Please open an issue or PR on GitHub.

Author

Dave Mkpa Eke - GitHub | X