Skip to content

Commit 28aae53

Browse files
committed
Clean up and update README.md
Release beta version
1 parent 913f979 commit 28aae53

15 files changed

+61
-1010
lines changed

.gitignore

+5-104
Original file line numberDiff line numberDiff line change
@@ -1,108 +1,9 @@
1-
# Byte-compiled / optimized / DLL files
2-
__pycache__/
3-
*.py[cod]
4-
*$py.class
5-
.DS_Store
1+
# python generated
62
.idea
3+
.DS_Store
4+
__pycache__
5+
.pytest_cache
6+
venv
77

8-
# C extensions
9-
*.so
10-
11-
# Distribution / packaging
12-
.Python
13-
env/
14-
build/
15-
develop-eggs/
168
dist/
17-
downloads/
18-
eggs/
19-
.eggs/
20-
lib/
21-
lib64/
22-
parts/
23-
sdist/
24-
var/
25-
wheels/
269
*.egg-info/
27-
.installed.cfg
28-
*.egg
29-
30-
# PyInstaller
31-
# Usually these files are written by a python script from a template
32-
# before PyInstaller builds the exe, so as to inject date/other infos into it.
33-
*.manifest
34-
*.spec
35-
36-
# Installer logs
37-
pip-log.txt
38-
pip-delete-this-directory.txt
39-
40-
# Unit test / coverage reports
41-
htmlcov/
42-
.tox/
43-
.coverage
44-
.coverage.*
45-
.cache
46-
nosetests.xml
47-
coverage.xml
48-
*.cover
49-
.hypothesis/
50-
51-
# Translations
52-
*.mo
53-
*.pot
54-
55-
# Django stuff:
56-
*.log
57-
local_settings.py
58-
59-
# Flask stuff:
60-
instance/
61-
.webassets-cache
62-
63-
# Scrapy stuff:
64-
.scrapy
65-
66-
# Sphinx documentation
67-
docs/_build/
68-
69-
# PyBuilder
70-
target/
71-
72-
# Jupyter Notebook
73-
.ipynb_checkpoints
74-
75-
# pyenv
76-
.python-version
77-
78-
# celery beat schedule file
79-
celerybeat-schedule
80-
81-
# SageMath parsed files
82-
*.sage.py
83-
84-
# dotenv
85-
.env
86-
87-
# virtualenv
88-
.venv
89-
venv/
90-
ENV/
91-
92-
# Spyder project settings
93-
.spyderproject
94-
.spyproject
95-
96-
# Rope project settings
97-
.ropeproject
98-
99-
# mkdocs documentation
100-
/site
101-
102-
# mypy
103-
.mypy_cache/
104-
docs/make.bat
105-
docs/make.bat
106-
107-
# vscode
108-
.vscode/

MANIFEST

-14
This file was deleted.

README.md

+51-42
Original file line numberDiff line numberDiff line change
@@ -4,33 +4,43 @@
44
<h2 align="center">Offline Text To Speech (TTS) converter for Python </h2>
55

66

7-
[![Downloads](https://pepy.tech/badge/pyttsx3)](https://pepy.tech/project/pyttsx3) ![Downloads](https://pepy.tech/badge/pyttsx3/week) [![](https://img.shields.io/github/languages/code-size/nateshmbhat/pyttsx3.svg?style=plastic)](https://github.com/nateshmbhat/pyttsx3) [![](https://img.shields.io/github/license/nateshmbhat/pyttsx3?style=plastic)](https://github.com/nateshmbhat/pyttsx3) [![](https://img.shields.io/pypi/v/pyttsx3.svg?style=plastic)](https://pypi.org/project/pyttsx3/) [![](https://img.shields.io/github/languages/top/nateshmbhat/pyttsx3.svg?style=plastic)](https://github.com/nateshmbhat/pyttsx3) [![](https://img.shields.io/badge/author-nateshmbhat-green.svg)](https://github.com/nateshmbhat)
7+
[![](https://pepy.tech/badge/py3-tts)](https://pepy.tech/badge/py3-tts)
8+
[![](https://pepy.tech/badge/py3-tts/month)](https://pepy.tech/badge/py3-tts/month)
89

10+
[![](https://img.shields.io/github/languages/code-size/thevickypedia/py3-tts.svg?style=plastic)](https://github.com/thevickypedia/py3-tts)
11+
[![](https://img.shields.io/github/license/thevickypedia/py3-tts?style=plastic)](https://github.com/thevickypedia/py3-tts)
912

10-
`pyttsx3` is a text-to-speech conversion library in Python. Unlike alternative libraries, **it works offline**.
13+
[![](https://img.shields.io/pypi/v/py3-tts.svg?style=plastic)](https://pypi.org/project/py3-tts/)
1114

12-
<a class="bmc-button" target="_blank" href="https://www.buymeacoffee.com/nateshmbhat"><img src="https://cdn.buymeacoffee.com/buttons/bmc-new-btn-logo.svg" alt="Buy me a coffee 😇"><span style="margin-left:5px;font-size:19px !important;">Buy me a coffee 😇</span></a>
15+
[![](https://img.shields.io/github/languages/top/thevickypedia/py3-tts.svg?style=plastic)](https://github.com/thevickypedia/py3-tts)
1316

14-
## Installation :
17+
[![](https://img.shields.io/badge/author-thevickypedia-green.svg)](https://github.com/thevickypedia)
1518

19+
`py3-tts` is a text-to-speech conversion library in Python. Unlike alternative libraries, **it works offline**.
1620

17-
pip install py3-tts
21+
## Installation
1822

19-
> If you get installation errors , make sure you first upgrade your wheel version using :
20-
`pip install --upgrade wheel`
23+
```shell
24+
pip install py3-tts
25+
```
26+
27+
> If you get installation errors, make sure you first upgrade your wheel version using
2128
22-
### Linux installation requirements :
29+
```shell
30+
pip install --upgrade wheel
31+
```
2332

24-
+ If you are on a linux system and if the voice output is not working , then :
33+
### Linux installation requirements
2534

26-
Install espeak , ffmpeg and libespeak1 as shown below:
35+
+ If you are on a linux system and if the voice output is not working,
2736

28-
```
29-
sudo apt update && sudo apt install espeak ffmpeg libespeak1
30-
```
37+
Install `espeak`, `ffmpeg` and `libespeak1` as shown below
3138

39+
```shell
40+
sudo apt update && sudo apt install espeak ffmpeg libespeak1
41+
```
3242

33-
## Features :
43+
## Features
3444

3545
- ✨Fully **OFFLINE** text to speech conversion
3646
- 🎈 Choose among different voices installed in your system
@@ -39,77 +49,76 @@
3949
- 📀 Save the speech audio as a file
4050
- ❤️ Simple, powerful, & intuitive API
4151

52+
## Usage
4253

43-
## Usage :
44-
45-
```python3
54+
```python
4655
import pyttsx3
56+
4757
engine = pyttsx3.init()
4858
engine.say("I will speak this text")
4959
engine.runAndWait()
5060
```
5161

5262
**Single line usage with speak function with default options**
5363

54-
```python3
64+
```python
5565
import pyttsx3
66+
5667
pyttsx3.speak("I will speak this text")
5768
```
5869

59-
60-
**Changing Voice , Rate and Volume :**
70+
**Changing Voice, Rate and Volume**
6171

62-
```python3
72+
```python
6373
import pyttsx3
64-
engine = pyttsx3.init() # object creation
6574

66-
""" RATE"""
67-
rate = engine.getProperty('rate') # getting details of current speaking rate
68-
print (rate) #printing current voice rate
69-
engine.setProperty('rate', 125) # setting up new voice rate
75+
engine = pyttsx3.init() # object creation
7076

77+
""" RATE"""
78+
rate = engine.getProperty('rate') # getting details of current speaking rate
79+
print(rate) # printing current voice rate
80+
engine.setProperty('rate', 125) # setting up new voice rate
7181

7282
"""VOLUME"""
73-
volume = engine.getProperty('volume') #getting to know current volume level (min=0 and max=1)
74-
print (volume) #printing current volume level
75-
engine.setProperty('volume',1.0) # setting up volume level between 0 and 1
83+
volume = engine.getProperty('volume') # getting to know current volume level (min=0 and max=1)
84+
print(volume) # printing current volume level
85+
engine.setProperty('volume', 1.0) # setting up volume level between 0 and 1
7686

7787
"""VOICE"""
78-
voices = engine.getProperty('voices') #getting details of current voice
79-
#engine.setProperty('voice', voices[0].id) #changing index, changes voices. o for male
80-
engine.setProperty('voice', voices[1].id) #changing index, changes voices. 1 for female
88+
voices = engine.getProperty('voices') # getting details of current voice
89+
# engine.setProperty('voice', voices[0].id) #changing index, changes voices. o for male
90+
engine.setProperty('voice', voices[1].id) # changing index, changes voices. 1 for female
8191

8292
engine.say("Hello World!")
8393
engine.say('My current speaking rate is ' + str(rate))
8494
engine.runAndWait()
8595
engine.stop()
8696

87-
8897
"""Saving Voice to a file"""
8998
# On linux make sure that 'espeak' and 'ffmpeg' are installed
9099
engine.save_to_file('Hello World', 'test.mp3')
91100
engine.runAndWait()
92101

93102
```
94103

95-
96-
97-
98-
### **Full documentation of the Library**
104+
### Full documentation of the Library
99105

100106
https://pyttsx3.readthedocs.io/en/latest/
101107

102-
103-
#### Included TTS engines:
108+
#### Included TTS engines
104109

105110
* sapi5
106111
* nsss
107112
* espeak
108113

109114
Feel free to wrap another text-to-speech engine for use with ``pyttsx3``.
110115

111-
### Project Links :
116+
### Project Links
112117

113-
* PyPI (https://pypi.python.org)
114-
* GitHub (https://github.com/nateshmbhat/pyttsx3)
118+
* PyPI (https://pypi.org/project/py3-tts/)
119+
* GitHub (https://github.com/thevickypedia/py3-tts)
115120
* Full Documentation (https://pyttsx3.readthedocs.org)
121+
122+
### Credits
123+
124+
**[nateshmbhat](https://github.com/nateshmbhat)** for the original code [pyttsx3](https://pypi.org/project/pyttsx3/)

README.rst

-92
This file was deleted.

0 commit comments

Comments
 (0)