# Google Speech
[](https://pypi.python.org/pypi/google_speech/)
[](https://github.com/desbma/GoogleSpeech/actions)
[](https://coveralls.io/github/desbma/GoogleSpeech?branch=master)
[](https://pypi.python.org/pypi/google_speech/)
[](https://github.com/desbma/GoogleSpeech/blob/master/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](http://sox.sourceforge.net/sox.html#EFFECTS) to the audio while playing it
## Installation
Google Speech requires [Python](https://www.python.org/downloads/) >= 3.7.
### From PyPI (with PIP)
1. If you don't already have it, [install pip](https://pip.pypa.io/en/stable/installing/) for Python 3
2. Install Google Speech: `pip3 install google_speech`
3. Install [SoX](http://sox.sourceforge.net/), 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](http://sourceforge.net/projects/sox/files/sox/), once installed you also need to copy [libmad DLL](http://ossbuild.googlecode.com/svn/trunk/Shared/Build/Windows/Win32/bin/libmad-0.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](https://pypi.python.org/pypi/setuptools#installation-instructions) 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](http://sox.sourceforge.net/), 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](http://sourceforge.net/projects/sox/files/sox/), once installed you also need to copy [libmad DLL](http://ossbuild.googlecode.com/svn/trunk/Shared/Build/Windows/Win32/bin/libmad-0.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](http://ubuntuforums.org/showthread.php?t=1813001&p=11090789#post11090789)):
`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`
- Save to MP3 file :
`google_speech -l en -o hello.mp3 "Hello Google, greetings from France !"`
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 -`
## Python usage
You can use `google_speech` from any Python script or module.
Sample code:
```
from google_speech import Speech
# say "Hello World"
text = "Hello World"
lang = "en"
speech = Speech(text, lang)
speech.play()
# you can also apply audio effects while playing (using SoX)
# see http://sox.sourceforge.net/sox.html#EFFECTS for full effect documentation
sox_effects = ("speed", "1.5")
speech.play(sox_effects)
# save the speech to an MP3 file (no effect is applied)
speech.save("output.mp3")
```
## License
[LGPLv2](https://www.gnu.org/licenses/old-licenses/lgpl-2.1-standalone.html)
Raw data
{
"_id": null,
"home_page": "https://github.com/desbma/GoogleSpeech",
"name": "google-speech",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "speech,audio,synthesis,voice,google,tts",
"author": "desbma",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/d8/b1/559e13507296318d50d8b3ca96d041d531df084a74ee89b72f88c8489157/google_speech-1.2.0.tar.gz",
"platform": null,
"description": "# Google Speech\n\n[](https://pypi.python.org/pypi/google_speech/)\n[](https://github.com/desbma/GoogleSpeech/actions)\n[](https://coveralls.io/github/desbma/GoogleSpeech?branch=master)\n[](https://pypi.python.org/pypi/google_speech/)\n[](https://github.com/desbma/GoogleSpeech/blob/master/LICENSE)\n\nGoogle Speech is a simple multiplatform command line tool to read text using Google Translate TTS (Text To Speech) API.\n\n## Features\n\n- Support 64 different languages\n- Can read text without length limit\n- Can read text from standard input\n- Automatically pre download the next sentences while playing the current one to avoid long pauses between sentences\n- Automatically store downloaded data in a local cache\n- Can apply any [SoX effect](http://sox.sourceforge.net/sox.html#EFFECTS) to the audio while playing it\n\n## Installation\n\nGoogle Speech requires [Python](https://www.python.org/downloads/) >= 3.7.\n\n### From PyPI (with PIP)\n\n1. If you don't already have it, [install pip](https://pip.pypa.io/en/stable/installing/) for Python 3\n2. Install Google Speech: `pip3 install google_speech`\n3. Install [SoX](http://sox.sourceforge.net/), with MP3 support.\n On Ubuntu and other Debian derivatives: `sudo apt-get install sox libsox-fmt-mp3`.\n Windows users can [download binaries on the SoX website](http://sourceforge.net/projects/sox/files/sox/), once installed you also need to copy [libmad DLL](http://ossbuild.googlecode.com/svn/trunk/Shared/Build/Windows/Win32/bin/libmad-0.dll) in the directory where you have installed SoX, and to add this directory to your PATH environment variable.\n\n### From source\n\n1. If you don't already have it, [install setuptools](https://pypi.python.org/pypi/setuptools#installation-instructions) for Python 3\n2. Clone this repository: `git clone https://github.com/desbma/GoogleSpeech`\n3. Install Google Speech: `python3 setup.py install`\n4. Install [SoX](http://sox.sourceforge.net/), with MP3 support.\n On Ubuntu and other Debian derivatives: `sudo apt-get install sox libsox-fmt-mp3`.\n Windows users can [download binaries on the SoX website](http://sourceforge.net/projects/sox/files/sox/), once installed you also need to copy [libmad DLL](http://ossbuild.googlecode.com/svn/trunk/Shared/Build/Windows/Win32/bin/libmad-0.dll) in the directory where you have installed SoX, and to add this directory to your PATH environment variable.\n\n## Command line usage\n\nRun `google_speech -h` to get full command line reference.\n\n### Examples\n\n- Plane stall alarm:\n\n `google_speech -l en stall -e delay 0.5 overdrive 20 repeat 5 speed 0.9 gain -5`\n\n- Female robot voice (idea from [here](http://ubuntuforums.org/showthread.php?t=1813001&p=11090789#post11090789)):\n\n `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`\n\n- Save to MP3 file :\n `google_speech -l en -o hello.mp3 \"Hello Google, greetings from France !\"`\n\nOn Unix systems, with Bash and pipes, you can be creative:\n\n- Bash greetings:\n\n `google_speech -l en \"Hello $USER, it is $(date)\"`\n\n- Countdown:\n\n `for i in {10..0}; do ( google_speech $i & ); sleep 1s; done`\n\n- Read a Chuck Norris joke:\n\n `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 -`\n\n## Python usage\n\nYou can use `google_speech` from any Python script or module.\n\nSample code:\n\n```\nfrom google_speech import Speech\n\n# say \"Hello World\"\ntext = \"Hello World\"\nlang = \"en\"\nspeech = Speech(text, lang)\nspeech.play()\n\n# you can also apply audio effects while playing (using SoX)\n# see http://sox.sourceforge.net/sox.html#EFFECTS for full effect documentation\nsox_effects = (\"speed\", \"1.5\")\nspeech.play(sox_effects)\n\n# save the speech to an MP3 file (no effect is applied)\nspeech.save(\"output.mp3\")\n\n```\n\n## License\n\n[LGPLv2](https://www.gnu.org/licenses/old-licenses/lgpl-2.1-standalone.html)\n",
"bugtrack_url": null,
"license": "",
"summary": "Read text using Google Translate TTS API",
"version": "1.2.0",
"project_urls": {
"Download": "https://github.com/desbma/GoogleSpeech/archive/1.2.0.tar.gz",
"Homepage": "https://github.com/desbma/GoogleSpeech"
},
"split_keywords": [
"speech",
"audio",
"synthesis",
"voice",
"google",
"tts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d8b1559e13507296318d50d8b3ca96d041d531df084a74ee89b72f88c8489157",
"md5": "b57deb559aade827975723fb0d5b7b9b",
"sha256": "9f5e7b87951110ba68608f1dea32bbe60d878a8e04ed41d02560f22abbc8b0d2"
},
"downloads": -1,
"filename": "google_speech-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "b57deb559aade827975723fb0d5b7b9b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 17945,
"upload_time": "2023-05-30T08:53:20",
"upload_time_iso_8601": "2023-05-30T08:53:20.350071Z",
"url": "https://files.pythonhosted.org/packages/d8/b1/559e13507296318d50d8b3ca96d041d531df084a74ee89b72f88c8489157/google_speech-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-30 08:53:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "desbma",
"github_project": "GoogleSpeech",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "google-speech"
}
JSON
