flutter_tts does not speak, or stops early, on Android or iOS
flutter_tts speak() returns but no sound is heardShort answer
Check platform setup first. On Android 11 and newer the manifest needs a queries entry for the TTS service, and minSdk must be 21 or higher. On iOS set the shared instance and an audio category. Then check that the language is available and await completion.
Fix it fast
1Find out which cause you have
Ask the plugin what it can see: engines (Android) and whether your language is available. An empty list or false tells you which cause applies.
final tts = FlutterTts(); print(await tts.getEngines); // Android only print(await tts.isLanguageAvailable("en-US"));2Match what you see, then jump to its fix
- 1
getEngines is empty or speak does nothing on Android 11 and newerAndroid 11+ package visibility hides the TTS serviceFix - 2
The app targets a minSdk below 21, or an older Kotlin plugin than the README namesAndroid minSdk or Kotlin plugin version is below the plugin's requirementFix - 3
Works on Android, silent on iOS, or it stops other audio in the appiOS audio session blocks or mutes the speechFix - 4
The first sentence is cut off by the nextSpeak is called again before the previous one finishedFix - 5
isLanguageAvailable returns falseThe language is not installed on the deviceFix
- 1
What does the error look like?
flutter_tts speak() returns but no sound is heardText to speech works on one phone but not on anotherSpeech starts and then the next speak() call cuts it off
Cause 1 of 5
Android 11+ package visibility hides the TTS service
1Check
The plugin needs to see the TextToSpeech service. Look for a queries block in the app manifest.
grep -n -A4 "<queries>" android/app/src/main/AndroidManifest.xml2Fix
Add a queries element with the TTS service intent, outside the application tag.
<queries>
<intent>
<action android:name="android.intent.action.TTS_SERVICE" />
</intent>
</queries>3Verify
Rebuild (a hot restart does not re-read the manifest) and print getEngines again.
flutter runConfirmed by pub.dev
Cause 2 of 5
Android minSdk or Kotlin plugin version is below the plugin's requirement
1Check
The plugin README asks for minSdkVersion 21 or higher and Kotlin Gradle plugin 1.9.10.
grep -rn -E "minSdk|org.jetbrains.kotlin.android" android/2Fix
Raise minSdk to 21 or higher, and the Kotlin plugin to the version the README names.
// android/app/build.gradle (or build.gradle.kts)
defaultConfig {
minSdk = 21
}3Verify
Build the app.
flutter build apk --debugConfirmed by pub.dev
Cause 3 of 5
iOS audio session blocks or mutes the speech
1Check
The README shows iOS-only calls: setSharedInstance and setIosAudioCategory.
grep -rn "setIosAudioCategory\|setSharedInstance" lib/2Fix
Set the shared instance and an audio category before speaking.
await tts.setSharedInstance(true);
await tts.setIosAudioCategory(
IosTextToSpeechAudioCategory.ambient,
[
IosTextToSpeechAudioCategoryOptions.allowBluetooth,
IosTextToSpeechAudioCategoryOptions.mixWithOthers,
],
IosTextToSpeechAudioMode.voicePrompt,
);3Verify
Run on a real iPhone and speak a short phrase.
flutter run -d <your-iphone-id>Confirmed by pub.dev
Cause 4 of 5
Speak is called again before the previous one finished
1Check
speak returns before audio ends unless you ask the plugin to wait.
grep -rn "awaitSpeakCompletion" lib/2Fix
Enable completion waiting once, then await each speak.
await tts.awaitSpeakCompletion(true);
await tts.speak("First sentence.");
await tts.speak("Second sentence.");3Verify
Both sentences should play in order.
flutter runConfirmed by pub.dev
Cause 5 of 5
The language is not installed on the device
1Check
setLanguage and isLanguageAvailable are listed for Android, iOS, Web and macOS.
print(await tts.isLanguageAvailable("en-US"));2Fix
Test availability before setting the language, and fall back to another locale.
if (await tts.isLanguageAvailable("en-US")) {
await tts.setLanguage("en-US");
}3Verify
Speak a phrase after setting the language.
await tts.speak("Hello");Confirmed by pub.dev
How do I stop it coming back?
- Test on a real device for each platform, not only on an emulator.
- Call setLanguage after checking isLanguageAvailable, never blindly.
- Keep one FlutterTts instance and configure it once at start-up.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Projects of mine built on the same technologies:
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- QistLockA NestJS and React SaaS driving an Android Device Owner agent that locks financed phones when payments lapse.
- Dispatch ProA real-time logistics platform: Flutter apps, Spring Boot services and a Kafka event pipeline on AWS.
Related fixes
Mobile apps
Flutter Image.network shows nothing or throws when the image fails
EXCEPTION: resolving an image codec
Image.network throws an exception that goes to FlutterError.onError when a download or decode fails, so a 404 leaves a red screen or an empty box.
3 causes, each with a fixMobile apps
image_picker closes the app or returns nothing after choosing a photo
With launchMode singleInstance the picker always returns RESULT_CANCELED
On Android the system can kill MainActivity while the picker is open, so the app restarts and the result never arrives.
3 causes, each with a fixMobile apps
CLIENT_ID and REVERSED_CLIENT_ID are not in GoogleService-Info.plist
ANDROID_CLIENT_ID is missing from GoogleService-Info.plist
Firebase's Google sign-in steps enable the Google provider first and only then have you download a new GoogleService-Info.plist.
2 causes, each with a fixMobile apps
Scheduled flutter_local_notifications never appear when the app is closed
zonedSchedule does nothing, with no error shown
Local notifications are scheduled with the system, so they should fire while the app is closed.
5 causes, each with a fixMobile apps
flutter_local_notifications throws ArgumentError: iOS settings must be set
Android settings must be set when targeting Android platform.
The plugin's initialize call checks that InitializationSettings holds settings for the platform the app is running on.
3 causes, each with a fixMobile apps
Flutter cannot open a file: OS Error No such file or directory
FileSystemException: Cannot open file, path = '...' (OS Error: No such file or directory, errno = 2)
Errno 2 means the exact path you gave does not exist on the device.
3 causes, each with a fix