https://github.com/tbetool/aws-polly
AWS Polly Text to Voice PHP Library
https://github.com/tbetool/aws-polly
Last synced: about 2 months ago
JSON representation
AWS Polly Text to Voice PHP Library
- Host: GitHub
- URL: https://github.com/tbetool/aws-polly
- Owner: TBETool
- License: gpl-3.0
- Created: 2018-08-20T11:41:18.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-24T10:35:50.000Z (over 3 years ago)
- Last Synced: 2025-04-16T02:03:16.977Z (2 months ago)
- Language: PHP
- Size: 24.4 KB
- Stars: 0
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
## AWS Polly Text-To-Speech PHP Library
Convert written text into natural-sounding audio in a variety of languages and voices.
This package use [AWS Polly](https://aws.amazon.com/polly/) service.
---
### Using the Library
#### Installation
Intall library in PHP project using composer
```
composer require tbetool/aws-polly
```
#### Using Library
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](#).
#### Setting output path
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
#### Convert Text to Speech
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.
---
### Exception handling
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();
}
```
---
### Other callable methods
##### Get supported languages
```
$polly->getLanguages();
```
_default:_ `en-US`
##### Get supported voices
```
$polly->getVoices();
```
_default:_ `Ivy`
---
### Supported language and voice list
list of supported language and voice strings
[https://docs.aws.amazon.com/polly/latest/dg/voicelist.html](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)
| 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 |
---
### Bug Reporting
If you found any bug, create an [issue](https://github.com/TBETool/aws-polly/issues/new).
---
### Support and Contribution
Something is missing?
* `Fork` the repositroy
* Make your contribution
* make a `pull request`