txt2audio

A small lib to convert text strings to audio files (mp3 & ogg) using Google Text to Speech api.

It uses:

• Node.js
• Google Text to Speech Api
• MP3
• Ogg Vorbis

Important!

To use Google Text to Speech Api you should, first, enable the api and set up an authentication method. You can read more here.

Installation

npm install txt2audio

How to use it

const Txt2Audio = require('txt2audio')

Then you should declare an object with the options you need.

const path = require('path')

let txt2audio = Txt2Audio({
  text: 'Fuck corona virus',
  filename: 'fck-corona',
  path: path.resolve(__dirname, 'audio'),
  languageCode: 'en-US',
  gender: 'female',
  ogg: true,
  debug: true
})

The Txt2Audio will return another function, generateAudio, which will generate the audio files and save them in the given path.

txt2audio.generateAudio()

Options

| Argument | Type | Default | Description | | -------------- | -------- | ------- | ------------------------------------------------ | | text | string | | text from which the audio file will be generated | | filename | string | | name of the generated file | | path | string | | folder where the file will be saved | | languageCode | string | en-US | set the language for the api | | gender | string | female | male or female | | ogg | bool | false | generate ogg version from the audio file | | debug | bool | false | prints the request object in the terminal |

You can find a list of languageCode and gender in the Google Text to Speech Api documentation.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Author

| | | :-------------------------------------------------------------------------: | | Gustavo Cardoso |

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.