[](https://pepy.tech/project/rlvoice-1) [](https://badge.fury.io/py/rlvoice-1)
<b>Credits to <a href="github.com/nateshmbhat">nateshmbhat</a> for creating the original library pyttsx3.</b>
<h2 align="center">Offline Text To Speech (TTS) converter for Python </h2>
`RLVoice` is a text-to-speech conversion library in Python. Unlike alternative libraries, **it works offline**.
## Installation :
pip install rlvoice-1
> If you get installation errors , make sure you first upgrade your wheel version using :
`pip install --upgrade wheel`
> **DO NOT USE** `pip install rlvoice`, make sure you add the `-1` next to it, or it will download the wrong package.
### Linux installation requirements :
+ If you are on a linux system and if the voice output is not working , then :
Install espeak , ffmpeg and libespeak1 as shown below:
```
sudo apt update && sudo apt install espeak ffmpeg libespeak1
```
### OS X installation requirements :
+ If you are on a MacOS system and if you get an error such as `NameError: name 'objc' is not defined. Did you mean: 'object'?` , then :
Install the `pyobjc` library as shown below:
```
pip install pyobjc==9.0.1
```
## Features :
- ✨Fully **OFFLINE** text to speech conversion
- 🎈 Choose among different voices installed in your system
- 🎛 Control speed/rate of speech
- 🎚 Tweak Volume
- 📀 Save the speech audio as a file
- ❤️ Simple, powerful, & intuitive API
## Usage :
```python3
import rlvoice
engine = rlvoice.init()
engine.say("I will speak this text")
engine.runAndWait()
```
**Single line usage with speak function with default options**
```python3
import rlvoice
rlvoice.speak("I will speak this text")
```
**Changing Voice , Rate and Volume :**
```python3
import rlvoice
engine = rlvoice.init() # object creation
""" RATE"""
rate = engine.getProperty('rate') # getting details of current speaking rate
print(rate) # printing current voice rate
engine.setProperty('rate', 125) # setting up new voice rate
"""VOLUME"""
volume = engine.getProperty('volume') # getting to know current volume level (min=0 and max=1)
print(volume) # printing current volume level
engine.setProperty('volume', 1.0) # setting up volume level between 0 and 1
"""VOICE"""
voices = engine.getProperty('voices') # getting details of current voice
# engine.setProperty('voice', voices[0].id) #changing index, changes voices. o for male
engine.setProperty('voice', voices[1].id) # changing index, changes voices. 1 for female
engine.say("Hello World!")
engine.say('My current speaking rate is ' + str(rate))
engine.runAndWait()
engine.stop()
"""Saving Voice to a file"""
# On linux make sure that 'espeak' and 'ffmpeg' are installed
engine.save_to_file('Hello World', 'test.mp3')
engine.runAndWait()
```
Full documentation is located in the ```docs``` folder.
#### Included TTS engines:
* sapi5
* nsss
* espeak
* coqui_ai_tts
Feel free to wrap another text-to-speech engine for use with ``rlvoice-1``.
### Project Links :
* PyPI (https://pypi.org/project/rlvoice-1)
* GitHub (https://github.com/Akul-AI/rlvoice-1)
Raw data
{
"_id": null,
"home_page": "https://github.com/Akul-AI/rlvoice-1",
"name": "rlvoice-1",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "rlvoice,pyttsx,ivona,pyttsx for python3,TTS for python3,rlvoice,text to speech for python,tts,text to speech,speech,speech synthesis,offline text to speech,offline tts,gtts",
"author": "AkulAI",
"author_email": "akulgoel2010@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0d/bb/33d32c8e3dcb750fa5b96d98a3923cfcc03b0c7ef31728387f8e3db2bbc4/rlvoice-1-1.3.4.tar.gz",
"platform": null,
"description": "\n[](https://pepy.tech/project/rlvoice-1) [](https://badge.fury.io/py/rlvoice-1)\n\n<b>Credits to <a href=\"github.com/nateshmbhat\">nateshmbhat</a> for creating the original library pyttsx3.</b>\n\n<h2 align=\"center\">Offline Text To Speech (TTS) converter for Python </h2>\n\n`RLVoice` is a text-to-speech conversion library in Python. Unlike alternative libraries, **it works offline**.\n\n## Installation :\n\n\n\tpip install rlvoice-1\n\n> If you get installation errors , make sure you first upgrade your wheel version using : \n`pip install --upgrade wheel`\n\n> **DO NOT USE** `pip install rlvoice`, make sure you add the `-1` next to it, or it will download the wrong package.\n\n### Linux installation requirements : \n\n+ If you are on a linux system and if the voice output is not working , then : \n\n\tInstall espeak , ffmpeg and libespeak1 as shown below: \n\n\t```\n\tsudo apt update && sudo apt install espeak ffmpeg libespeak1\n\t```\n\n### OS X installation requirements : \n\n+ If you are on a MacOS system and if you get an error such as `NameError: name 'objc' is not defined. Did you mean: 'object'?` , then : \n\n\tInstall the `pyobjc` library as shown below: \n\n\t```\n\tpip install pyobjc==9.0.1\n\t```\n\n\n## Features : \n\n- \u2728Fully **OFFLINE** text to speech conversion\n- \ud83c\udf88 Choose among different voices installed in your system\n- \ud83c\udf9b Control speed/rate of speech\n- \ud83c\udf9a Tweak Volume\n- \ud83d\udcc0 Save the speech audio as a file\n- \u2764\ufe0f Simple, powerful, & intuitive API\n\n\n## Usage :\n\n```python3\nimport rlvoice\n\nengine = rlvoice.init()\nengine.say(\"I will speak this text\")\nengine.runAndWait()\n```\n\n**Single line usage with speak function with default options**\n\n```python3\nimport rlvoice\n\nrlvoice.speak(\"I will speak this text\")\n```\n\n\t\n**Changing Voice , Rate and Volume :**\n\n```python3\nimport rlvoice\n\nengine = rlvoice.init() # object creation\n\n\"\"\" RATE\"\"\"\nrate = engine.getProperty('rate') # getting details of current speaking rate\nprint(rate) # printing current voice rate\nengine.setProperty('rate', 125) # setting up new voice rate\n\n\"\"\"VOLUME\"\"\"\nvolume = engine.getProperty('volume') # getting to know current volume level (min=0 and max=1)\nprint(volume) # printing current volume level\nengine.setProperty('volume', 1.0) # setting up volume level between 0 and 1\n\n\"\"\"VOICE\"\"\"\nvoices = engine.getProperty('voices') # getting details of current voice\n# engine.setProperty('voice', voices[0].id) #changing index, changes voices. o for male\nengine.setProperty('voice', voices[1].id) # changing index, changes voices. 1 for female\n\nengine.say(\"Hello World!\")\nengine.say('My current speaking rate is ' + str(rate))\nengine.runAndWait()\nengine.stop()\n\n\"\"\"Saving Voice to a file\"\"\"\n# On linux make sure that 'espeak' and 'ffmpeg' are installed\nengine.save_to_file('Hello World', 'test.mp3')\nengine.runAndWait()\n\n```\n\n\nFull documentation is located in the ```docs``` folder.\n\n\n#### Included TTS engines:\n\n* sapi5\n* nsss\n* espeak\n* coqui_ai_tts\n\nFeel free to wrap another text-to-speech engine for use with ``rlvoice-1``.\n\n### Project Links :\n\n* PyPI (https://pypi.org/project/rlvoice-1)\n* GitHub (https://github.com/Akul-AI/rlvoice-1)\n",
"bugtrack_url": null,
"license": "",
"summary": "Text to Speech (TTS) library for Python 3. Works without internet connection or delay. Supports multiple TTS engines, including Sapi5, nsss, and espeak.",
"version": "1.3.4",
"project_urls": {
"Homepage": "https://github.com/Akul-AI/rlvoice-1"
},
"split_keywords": [
"rlvoice",
"pyttsx",
"ivona",
"pyttsx for python3",
"tts for python3",
"rlvoice",
"text to speech for python",
"tts",
"text to speech",
"speech",
"speech synthesis",
"offline text to speech",
"offline tts",
"gtts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "34525433f8c21660977304bc530f0bd161212c316fafda2e971e4fe19da0f19b",
"md5": "95efb32dc1350f655a63a0b593cb2044",
"sha256": "6caf0f854b47fd68b93b84428f5d4fa3e2c8aa0c5d8e58e89c993b8f9a797e4b"
},
"downloads": -1,
"filename": "rlvoice_1-1.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "95efb32dc1350f655a63a0b593cb2044",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 29206,
"upload_time": "2023-12-23T18:44:45",
"upload_time_iso_8601": "2023-12-23T18:44:45.290459Z",
"url": "https://files.pythonhosted.org/packages/34/52/5433f8c21660977304bc530f0bd161212c316fafda2e971e4fe19da0f19b/rlvoice_1-1.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0dbb33d32c8e3dcb750fa5b96d98a3923cfcc03b0c7ef31728387f8e3db2bbc4",
"md5": "fa4492bb2a8c4168eb144d5d709fe1be",
"sha256": "2749105774c4306d746979672cc74302ff1d05dd56f9874eccbe8e04dd505558"
},
"downloads": -1,
"filename": "rlvoice-1-1.3.4.tar.gz",
"has_sig": false,
"md5_digest": "fa4492bb2a8c4168eb144d5d709fe1be",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 26972,
"upload_time": "2023-12-23T18:44:46",
"upload_time_iso_8601": "2023-12-23T18:44:46.360682Z",
"url": "https://files.pythonhosted.org/packages/0d/bb/33d32c8e3dcb750fa5b96d98a3923cfcc03b0c7ef31728387f8e3db2bbc4/rlvoice-1-1.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-23 18:44:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Akul-AI",
"github_project": "rlvoice-1",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "rlvoice-1"
}
JSON
