Fork me on GitHub

Text translation for Asterisk

Text translation and language detection for Asterisk using Google Translate API.

This script makes use of Google Translate API v2 to translate text strings and return them as channel variables. See README for a complete list of supported languages.


Perl: The Perl Programming Language
perl-libwww: The World-Wide Web library for Perl
perl-libjson: Module for manipulating JSON-formatted data
IO-Socket-SSL: Perl module that implements an interface to SSL sockets
API Key from google
Internet access in order to contact google and get the language data.


To install copy googletranslate.agi to your agi-bin directory.
Usually this is /var/lib/asterisk/agi-bin/
To make sure check your /etc/asterisk/asterisk.conf file


agi(googletranslate.agi,"text",[target language],[source language]): The text string will be send to google translate for translation to target language. The translated text will be stored as a channel variable named 'gtranslation'. The setting of source language is optional, if not set the tranlator engine will try to auto detect it. If both target language and source language are omitted the script performs language detection on the given text string and returns the two-character language code as the value of the channel variable 'glang'.

Asterisk dialplan examples:

;Translate a text string from english to french:
exten => 1234,1,agi(googletranslate.agi,"This is some random text.",fr)
exten => 1234,n,Verbose(1,Translated text: ${gtranslation})

;Translate from greek to german:
exten => 1234,1,agi(googletranslate.agi,"Αυτό είναι ένα απλό τέστ στα ελληνικά.",de)
exten => 1234,n,Verbose(1,Translated text: ${gtranslation})

;Translate from japanese to english:
exten => 1234,1,agi(googletranslate.agi,"これは、日本の簡単なテストです。良い一日を。",en)
exten => 1234,n,Verbose(1,Translated text: ${gtranslation})

;Translate string to many languages:
exten => 1235,1,Set(MYTEXT="This is some random text for translation.")
exten => 1235,n,agi(googletranslate.agi,"${MYTEXT}",it)
exten => 1235,n,Verbose(1,In Italian: ${gtranslation})

exten => 1235,n,agi(googletranslate.agi,"${MYTEXT}",fr)
exten => 1235,n,Verbose(1,In French: ${gtranslation})

exten => 1235,n,agi(googletranslate.agi,"${MYTEXT}",ja)
exten => 1235,n,Verbose(1,In Japanese: ${gtranslation})

exten => 1235,n,agi(googletranslate.agi,"${MYTEXT}",es)
exten => 1235,n,Verbose(1,In Spanish: ${gtranslation})

;Detect text language:
exten => 1236,1,Set(MYTEXT="This is some random text for detection.")
exten => 1236,n,agi(googletranslate.agi,"${MYTEXT}")
exten => 1236,n,Verbose(1,Detected language: ${glang})


The googletranslate script for asterisk is distributed under the GNU General Public License v2.


Lefteris Zafiris (


You can get the latest stable version here.
Develompent snapshots are available in either zip or tar formats.

You can also clone the project with Git by running:

$ git clone git://


Speech recognition for asterisk
GoogleTTS text to speech script for asterisk
Text translation using Microsoft Translator API for asterisk
Speech synthesis using Microsoft Translator API for Asterisk
Asterisk Flite text to speech module
Asterisk e-Speak text to speech module