Skip to main content

Read text using Google Translate TTS API

Project description

Latest version Tests status Coverage Supported Python versions License

Google Speech is a simple multiplatform command line tool to read text using Google Translate TTS (Text To Speech) API.

Features

  • Support 64 different languages

  • Can read text without length limit

  • Can read text from standard input

  • Automatically pre download the next sentences while playing the current one to avoid long pauses between sentences

  • Automatically store downloaded data in a local cache

  • Can apply any SoX effect to the audio while playing it

Installation

Google Speech requires Python >= 3.3.

From PyPI (with PIP)

  1. If you don’t already have it, install pip for Python 3 (not needed if you are using Python >= 3.4)

  2. Install Google Speech: pip3 install google_speech

  3. Install SoX, with MP3 support. On Ubuntu and other Debian derivatives: sudo apt-get install sox libsox-fmt-mp3. Windows users can download binaries on the SoX website, once installed you also need to copy libmad DLL in the directory where you have installed SoX, and to add this directory to your PATH environment variable.

From source

  1. If you don’t already have it, install setuptools for Python 3

  2. Clone this repository: git clone https://github.com/desbma/GoogleSpeech

  3. Install Google Speech: python3 setup.py install

  4. Install SoX, with MP3 support. On Ubuntu and other Debian derivatives: sudo apt-get install sox libsox-fmt-mp3. Windows users can download binaries on the SoX website, once installed you also need to copy libmad DLL in the directory where you have installed SoX, and to add this directory to your PATH environment variable.

Command line usage

Run google_speech -h to get full command line reference.

Examples

  • Plane stall alarm:

    google_speech -l en stall -e delay 0.5 overdrive 20 repeat 5 speed 0.9 gain -5

  • Female robot voice (idea from here):

    google_speech -l en "Hello, I am a stupid robot voice" -e speed 0.9 overdrive 10 echo 0.8 0.7 6 0.7 echo 0.8 0.7 10 0.7 echo 0.8 0.7 12 0.7 echo 0.8 0.88 12 0.7 echo 0.8 0.88 30 0.7 echo 0.6 0.6 60 0.7

On Unix systems, with Bash and pipes, you can be creative:

  • Bash greetings:

    google_speech -l en "Hello $USER, it is $(date)"

  • Countdown:

    for i in {10..0}; do ( google_speech $i & ); sleep 1s; done

  • Read a Chuck Norris joke:

    curl -s http://api.icndb.com/jokes/random/ | python3 -c 'import html.parser, json, sys; print(html.parser.HTMLParser().unescape(json.load(sys.stdin)["value"]["joke"]))' | google_speech -

License

GPLv3

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

google_speech-1.0.16.tar.gz (10.3 kB view details)

Uploaded Source

File details

Details for the file google_speech-1.0.16.tar.gz.

File metadata

File hashes

Hashes for google_speech-1.0.16.tar.gz
Algorithm Hash digest
SHA256 38dd6c87e03aef00c0103ff7d535783bdbe82e66b37be91b298dda94288be63e
MD5 14f1f8617b08dc745db41f20a12fa3cf
BLAKE2b-256 5ea522fcc7d695cd988ee0f09fb669327f813415cc302f587bf5f95aa27187fe

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page