Home » Android » Android Core » Android Text-To-Speech Application

About Ilias Tsagklis

Ilias Tsagklis
Ilias is a software developer turned online entrepreneur. He is co-founder and Executive Editor at Java Code Geeks.

Android Text-To-Speech Application

One of the many features that Android provides out of the box is the one of “speech synthesis”. This is also known as “Text-To-Speech” (TTS) and is mainly the capability of the device to “speak” text of different languages. This feature was introduced in version 1.6 of the Android platform and you can find an introductory article at the official Android-Developers blog. In this tutorial I am going to show you how to quickly introduce TTS capabilities into your application. Let’s get started by creating a new Eclipse project under the name “AndroidTextToSpeechProject” as shown in the following image: Note that Android 1.6 was used as the build target and that for the minimum SDK version I used the value 4, since this functionality is not provided by the previous versions. The first step to use the TTS API is to check if it is actually supported by the device. For that purpose there is a special action named ACTION_CHECK_TTS_DATA which is included in the TextToSpeech.Engine. As the Javadoc states, this is used by an Intent to “verify the proper installation and availability of the resource files on the system”. In case the resourses are not available, another action named ACTION_INSTALL_TTS_DATA is used in order to trigger their installation. Note that the SDK’s emulator supports TTS with no configuration needed. Before using the TTS engine, we have to be sure that it has properly been initialized. In order to get informed on whether this has happened, we can implement an interface called OnInitListener. The method onInit will be invoked when the engine initialization has completed with the accompanying status. After initialization, we can use the TextToSpeech class to make the device speak. The relevant method is named speak, where the text, the queue mode and some additional parameters can be passed. It is important to describe queue mode. It is the queuing strategy to be used by the TTS engine, i.e. what to do when a new text has been queued to the engine. There are two options:

  • QUEUE_ADD: the new entry is added at the end of the playback queue
  • QUEUE_FLUSH: all entries in the playback queue (media to be played and text to be synthesized) are dropped and replaced by the new entry

All the above are translated to the code provided below:

package com.javacodegeeks.android.tts;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.speech.tts.TextToSpeech;
import android.speech.tts.TextToSpeech.OnInitListener;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class TtsActivity extends Activity implements OnInitListener {
    private int MY_DATA_CHECK_CODE = 0;
    private TextToSpeech tts;
    private EditText inputText;
    private Button speakButton;
 public void onCreate(Bundle savedInstanceState) {
  inputText = (EditText) findViewById(R.id.input_text);
  speakButton = (Button) findViewById(R.id.speak_button);
  speakButton.setOnClickListener(new OnClickListener() {            
   public void onClick(View v) {
       String text = inputText.getText().toString();
       if (text!=null && text.length()>0) {
    Toast.makeText(TtsActivity.this, "Saying: " + text, Toast.LENGTH_LONG).show();
    tts.speak(text, TextToSpeech.QUEUE_ADD, null);
  Intent checkIntent = new Intent();
      startActivityForResult(checkIntent, MY_DATA_CHECK_CODE);
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        if (requestCode == MY_DATA_CHECK_CODE) {
            if (resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS) {
                // success, create the TTS instance
                tts = new TextToSpeech(this, this);
            else {
                // missing data, install it
                Intent installIntent = new Intent();


    public void onInit(int status) {        
        if (status == TextToSpeech.SUCCESS) {
                    "Text-To-Speech engine is initialized", Toast.LENGTH_LONG).show();
        else if (status == TextToSpeech.ERROR) {
                    "Error occurred while initializing Text-To-Speech engine", Toast.LENGTH_LONG).show();

The engine support is checked in the onActivityResult method. If there is support for TTS, we initialize the engine, else a new Intent is launched in order to trigger the relevant installation. After initialization, we used a Toast in order to notify the user about the operation status. Finally, we use a text field where the text is provided by the user and a button which feeds the engine with the provided text. In order to run the project, an appropriate emulator device is needed. If you have none available, use the following configuration in the AVD manager (note that “Android 1.6 – API Level 4” or higher is needed): Provide the text you wish to hear into the text field, hit the button and listen to emulator speak to you! That’s all folks, nice and simple. Now, make your devices speak! You can download the created Eclipse project here.

Related Articles :
Related Examples :
(0 rating, 0 votes)
You need to be a registered member to rate this.
17 Comments Views Tweet it!
Do you want to know how to develop your skillset to become a Java Rockstar?
Subscribe to our newsletter to start Rocking right now!
To get you started we give you our best selling eBooks for FREE!
1. JPA Mini Book
2. JVM Troubleshooting Guide
3. JUnit Tutorial for Unit Testing
4. Java Annotations Tutorial
5. Java Interview Questions
6. Spring Interview Questions
7. Android UI Design
and many more ....
Email address:

Leave a Reply

17 Comments on "Android Text-To-Speech Application"

newest oldest most voted
Notify of

I wrote a Text-To-Speech app just for fun.
Source: https://github.com/manuw/MyVoice

Yash Raithatha

alert(‘Filter user input. They can insert anything’);

kuldeep singh

i want to create an app which reads email. is it possible if yes then how? pls send me appropriate codes.
my email id is: kskuldeep230@gmail.com

Selvameena N

Hi Deepthy,

i used ur code and working fine but i included a back button and calling finish(); .This forcing my app to stop unexpectedly. why is this so? help me


sir how to set male voice to text to speech

Sandhya R

did u find a solution for that? i looking for the same answer.


plz snd reply to my mail id


its is possible to leave a time gap between two words pronounciation in text to speech………..after a words pronounced only next word should come


i need an abstract documentation for this text to speech conversion will u plz provide it for me, and when i m running the emulator its not responding and sometimes it failed to install …. how can i run it ?give me solution


sir its nt workng…do we have to take any permission in the mainfest file…????


no priyanka its working well…. nothing is required in manifest file……….. just simply copy paste n do required changes

Ravi Agarwal

Its awesome


i required the android code for voice visualizer from microphone.if got please send to my email id:dineesh2503@gmail.com

hello peeps … Im a newbie in programming …but since the source code here is ready to copy and paste …i thought it will work just fine … but i was just frustrated … can anyone please help me how to do this step by step … here is what I did : 1. i opened my eclipse … 2.then i followed how to make the emulator … 3.then i created a new eclipse project with the suggested filename .. 4. then i pasted the source code in between the relative layout .. 5. i clicked run … and nothing… Read more »

Nice work in here… Works perfectly fine and great.. Thanks…. Great work

Dhiraj Shende, NAGPUR
Dhiraj Shende, NAGPUR

Can we speak the provided text without of onclick of button…
i want to play the my name every time when activity is started…

Ryan S

Hi, this is some great code. But i have one slight problem. There is an error showing up for both the input_text and speak_button. It’s telling me it cannot be resolved or it is not a field. Any clue on what I can do to solve this problem? Thanks.