Skip to content

Latest commit

 

History

History
254 lines (210 loc) · 8.76 KB

README.md

File metadata and controls

254 lines (210 loc) · 8.76 KB

Generate speech audio from super long text through machine (via "Amazon Polly", "ffmpeg").

Do you want to:

  • Share your ideas anonymously on YouTube?
  • Pretend on phone that you are not a kid (Home Alone)?
  • Learn good english pronunciation for a speech?
  • Make your computer read out your school notes?
  • Experiment with various voices from around the globe?
  • Or, Upload Wikipedia TTS videos on YouTube?

Sample: "I want to order a stuffed crust pizza".

setup

install

  1. Install Node.js, if not installed.
  2. Run npm install -g extra-amazontts in console.
  3. To install this as a package use npm install extra-amazontts.

get service account key

  1. Create an account on Amazon Web Services.
  2. Create a new project, and select it.
  3. Enable Cloud Text-to-Speech API for the project.
  4. Add credentials to your project.
  5. Which API are you using? Cloud Text-to-Speech API.
  6. Are you planning to use this API with App Engine or Compute Engine? No, I’m not using them.
  7. Select What credentials do I need?.
  8. Create a service account.
  9. Service account name: googletts (your choice).
  10. Role: Project -> Owner.
  11. Service account ID: googletts (same as name).
  12. Key type: JSON.
  13. Select Continue.
  14. Copy downloaded file to a directory.
  15. Rename the file to account_id.json.

set environment variable

  1. Copy path of account_id.json.
  2. Set environment variable GOOGLE_APPLICATION_CREDENTIALS to it.

On Windows, use RapidEE to set environment variable.

# on linux or macos console
export GOOGLE_APPLICATION_CREDENTIALS="[PATH OF account_id.json]"

# on windows powershell
$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH OF account_id.json]"

console

amazontts "I want to order a stuffed crust pizza"
# out.mp3 created (yay!)

amazontts -t speech.txt -o speech.mp3
# speech.mp3 created from text in speech.txt

amazontts "Hello 911, my husband is in danger!" -vsg FEMALE
# out.mp3 created with female voice

echo "Dead man walking." | amazontts --log -vn en-US-Wavenet-B
# out.mp3 created with different male voice (log enabled)

Available TTS voices?

reference

amazontts [options] <text>
# text: input text

# Options:
# --help:        show this help
# -q, --quiet:   enable quiet mode
# -o, --output:  set output audio file (out.mp3)
# -t, --text:    set input text file
# -r, --retries: set speech synthesis retries (8)
# -c, --credentials: set credentials path
# -a, --acodec:      set acodec (copy)
# -sr, --service_region:    set region to send service requests to
# -se, --service_endpoint:  set endpoint to send requests to
# -ci, --credentials_id:    set AWS access key id
# -ck, --credentials_key:   set AWS secret access key
# -ae, --audio_encoding:    set audio encoding
# -as, --audio_sample:      set audio sample rate/frequency in Hz
# -tt, --text_type:         set text type (text)
# -lc, --language_code:     set language code
# -ll, --language_lexicons: set pronounciation lexicon names
# -vn, --voice_name:        set voice name
# -vg, --voice_gender:      set voice gender
# -qb, --quote_break:        set quoted text break time (250)
# -qe, --quote_emphasis:     set quoted text emphasis level (moderate)
# -hb, --heading_break:      set heading text break time (4000)
# -hd, --heading_difference: set heading text break difference (250)
# -he, --heading_emphasis:   set heading text emphasis level (strong)
# -eb, --ellipsis_break:     set ellipsis break time (1500)
# -db, --dash_break:         set dash break time (500)
# -nb, --newline_break:      set newline break time (1000)
# -bl, --block_length:       set SSML block length (3000)
# -bs, --block_separator:    set SSML block separator (.)
## (all times are in milliseconds)

# Environment variables:
$GOOGLETTS_LOG     # enable log (0)
$GOOGLETTS_OUTPUT  # set output audio file (out.mp3)
$GOOGLETTS_TEXT    # set input text file
$GOOGLETTS_RETRIES # set speech synthesis retries (8)
$GOOGLE_APPLICATION_CREDENTIALS  # set google credentials path
$GOOGLETTS_CREDENTIALS           # set google credentials path
$GOOGLETTS_ACODEC                # set audio acodec (copy)
$GOOGLETTS_AUDIOCONFIG_AUDIOENCODING # set audio encoding
$GOOGLETTS_AUDIOCONFIG_PITCH         # set audio pitch (0.0)
$GOOGLETTS_AUDIOCONFIG_SPEAKINGRATE  # set audio speaking rate (1.0)
$GOOGLETTS_VOICE_LANGUAGECODE    # set voice language code (en-US)
$GOOGLETTS_VOICE_SSMLGENDER      # set voice SSML gender (NEUTRAL)
$GOOGLETTS_VOICE_NAME            # set voice name (en-US-Wavenet-D)
$GOOGLETTS_QUOTE_BREAKTIME       # set quoted text break time (250)
$GOOGLETTS_QUOTE_EMPHASISLEVEL   # set quoted text emphasis level (moderate)
$GOOGLETTS_HEADING_BREAKTIME     # set heading text break time (4000)
$GOOGLETTS_HEADING_BREAKDIFF     # set heading text break difference (250)
$GOOGLETTS_HEADING_EMPHASISLEVEL # set heading text emphasis level (strong)
$GOOGLETTS_ELLIPSIS_BREAKTIME    # set ellipsis break time (1500)
$GOOGLETTS_DASH_BREAKTIME        # set dash break time (500)
$GOOGLETTS_NEWLINE_BREAKTIME     # set newline break time (1000)
$GOOGLETTS_BLOCK_LENGTH    # set SSMLs block length (5000)
$GOOGLETTS_BLOCK_SEPARATOR # set SSMLs block separator (.)

package

const googletts = require('extra-googletts');

await googletts('out.mp3', 'I want to order a stuffed crust pizza');
// out.mp3 created (yay!)

const fs = require('fs');
var speech = fs.readFileSync('speech.txt', 'utf8');
await googletts('speech.mp3', speech)
// speech.mp3 created from text in speech.txt

await googletts('out.mp3', 'Hello 911, my husband is in danger!', {
  voice: {ssmlGender: 'FEMALE'}
});
// out.mp3 created with female voice

await googletts('out.mp3', 'Dead man walking.', {
  voice: {name: 'en-US-Wavenet-B'}, log: true
});
// out.mp3 created with different male voice (log enabled)

reference

const googletts = require('extra-googletts');

googletts(output, text, options={})
// output:  output audio file
// text:    input text
// options: given below
// -> Promise <table of contents>

// Default options:
options = {
  stdio: [0, 1, 2], // set child process stdio
  log: false,       // enable log
  retries: 8,       // set speech synthesis retries
  credentials: {
    keyFilename: '' // path to credentials
    // see other TTS client options below
  },
  acodec: 'copy',    // set audio acodec
  audioConfig: {
    audioEncoding: null, // set audio encoding
    pitch: 0.0,          // set audio pitch
    speakingRate: 1.0    // set audio speaking rate
  },
  voice: {
    languageCode: 'en-US',   // set voice language code
    ssmlGender: 'NEUTRAL'    // set voice SSML gender
    name: 'en-US-Wavenet-D', // set voice name
  }
  quote: {
    breakTime: 250,           // set quoted text break time
    emphasisLevel: 'moderate' // set quoted text emphasis level
  },
  heading: {
    breakTime: 4000,         // set heading text break time
    breakDiff: 250,          // set heading text break difference
    emphasisLevel: 'strong', // set heading text emphasis level
  },
  ellipsis: {
    breakTime: 1500 // set ellipsis break time
  },
  dash: {
    breakTime: 500  // set dash break time
  },
  newline: {
    breakTime: 1000 // set newline break time
  },
  block: {
    length: 5000,  // set SSMLs block length
    separator: '.' // set SSMLs block separator
  }
}

similar

Do you need anything similar?

Suggestions are welcome. Please create an issue.

nodef

References: SSML, TTS voices, TTS client docs.