README

Convert written text into natural-sounding audio in a variety of languages and voices.
This package use AWS Polly service.

Intall library in PHP project using composer

composer require tbetool/aws-polly

After installing the library, create WatsonTts object

$polly = new AwsPolly(
    'aws_key', 
    'aws_secret', 
    'aws_region'
);

AWS key, secret can be obtained by creating IAM user in AWS console. For more detail follow Creating IAM for Polly.

Set absolute path of the directory where to save the output. You don't need to provide a file name as it will be auto generated.

$path = '/aboslute/path/to/directory';

$polly->setOutputPath($path);

NOTE: You can also pass output path with textToVoice() which will override this path

Pass text to convert to speech.

$file = $polly->textToVoice(
    'Hello World',
    $param
);

$params should be array and can have following content.

$param = [
    'language' => 'en-US',
    'voice' => 'Justin',
    'output_path' => '/absolute/file/path'
]

This will return the absolute path of the file created if text to speech conversion is successful, otherwise will throw Exception.

Every function throws an Exception in case of any error/issue. Bind the code block within try-catch block to catch any exception occurred.

Ex:

try {
    $polly->textToVoice('Hello world');
} catch (Exception $exception) {
    echo $exception->getMessage();
}

$polly->getLanguages();

default: en-US

$polly->getVoices();

default: Ivy

list of supported language and voice strings

Country	language	voice	gender
Danish	da-DK	Mads	male
		Naja	female
Dutch	nl-NL	Ruben	male
		Lotte	female
English (Australian)	en-AU	Russell	male
		Nicole	female
English (British)	en-GB	Brian	male
		Amy	female
		Emma	female
English (Indian)	en-IN	Aditi	female
		Raveena	female
English (US)	en-US	Joey	male
		Justin	male
		Matthew	male
		Ivy	female
		Joanna	female
		Kendra	female
		Kimberly	female
		Salli	female
English (Welsh)	en-GB-WLS	Geraint	male
French	fr-FR	Mathieu	male
		Celine	female
		Lea	female
French (Canadian)	fr-CA	Chantal	female
German	de-DE	Hans	male
		Marlene	female
		Vicki	female
Hindi	hi-IN	Aditi	female
Icelandic	is-IS	Karl	male
		Dora	female
Italian	it-IT	Giorgio	male
		Carla	female
Japanese	ja-JP	Takumi	male
		Mizuki	female
Korean	ko-KR	Seoyeon	female
Norwegian	nb-NO	Liv	female
Polish	pl-PL	Jacek	male
		Jan	male
		Ewa	female
		Maja	female
Portuguese (Brazilian)	pt-BR	Ricardo	male
		Vitoria	female
Portuguese (European)	pt-PT	Cristiano	male
		Ines	female
Romanian	ro-RO	Carmen	female
Russian	ru-RU	Maxim	male
		Tatyana	female
Spanish (European)	en-ES	Enrique	male
		Conchita	female
Spanish (Latin American)	es-US	Miguel	male
		Penelope	female
Swedish	sv-SE	Astrid	female
Turkish	tr-TR	Filiz	female
Welsh	cy-GB	Gwyneth	female

If you found any bug, create an issue.

Something is missing?

tbetool / aws-polly