NPM Paketi

A cross-platform React Native module for speech recognition and voice interaction, supporting both Android and iOS. Easily integrate voice commands and speech-to-text features into your React Native apps.

react-native-speech-module

Custom native speech-to-text module for React Native.
No third-party SDK — uses Android SpeechRecognizer and iOS SFSpeechRecognizer directly.
Compatible with React Native New Architecture (0.82+).

---

Installation

npm install github:Muhammet-Duran/react-native-speech-module

Android

No extra steps. Autolinking handles everything.

iOS

cd ios && pod install

Then in Xcode, add SpeechModule.swift and SpeechModuleBridge.m to your target.

---

Permissions

Android

Add to AndroidManifest.xml (auto-merged via the package manifest):

<uses-permission android:name="android.permission.RECORD_AUDIO" />

iOS

Add to Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Microphone access is required for voice input.</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>Speech recognition is required to convert voice to text.</string>

---

Usage

import { Pressable, Text, TextInput } from "react-native";
import { useVoice } from "react-native-speech-module";

const MyScreen = () => {
  const { status, displayedText, toggleListening, onTextChange } =
    useVoice("tr-TR");

  return (
    <>
      <TextInput value={displayedText} onChangeText={onTextChange} />
      <Pressable
        onPress={toggleListening}
        style={{
          padding: 12,
          backgroundColor: "#007AFF",
          borderRadius: 6,
          alignItems: "center",
          marginTop: 8,
        }}
      >
        <Text style={{ color: "white", fontWeight: "bold" }}>
          {status === "listening" ? "Stop" : "Speak"}
        </Text>
      </Pressable>
    </>
  );
};

---

API

useVoice(locale?: string)

Return value	Type	Description
status	VoiceStatus	idle / listening / processing / typing / done
displayedText	string	Transcribed text (animated)
isListening	boolean	Shorthand for status === 'listening'
error	string | null	Last error message
toggleListening	() => Promise<void>	Start / stop listening
onTextChange	(text: string) => void	Manual text edit handler

voiceService

Low-level bridge. Use useVoice instead unless you need custom orchestration.

requestMicrophonePermission()

Requests Android microphone permission. iOS is handled automatically.

---

How it works

1. toggleListening → SpeechModule.startListening(locale)
2. Android SpeechRecognizer / iOS SFSpeechRecognizer streams audio
3. Partial results fire onSpeechPartialResults → live preview in input
4. Final result fires onSpeechResults → silence detection triggers commit
5. onSpeechEnd → typing animation starts, text revealed character by character
6. A 1.2s fallback timer ensures text appears even if onSpeechEnd is delayed

---

License

MIT