Metadata-Version: 2.1
Name: willspeak
Version: 0.3.2
Summary: Python Text to Speach using Microsoft Sapi5 with a server/client model
Home-page: https://github.com/willforde/willspeek.git
License: GPL-2.0-only
Keywords: tts,sapi5,speech,voice
Author: willforde
Author-email: willforde@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: No Input/Output (Daemon)
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Natural Language :: English
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Sound Synthesis
Requires-Dist: aiohttp (>=3.8.3,<4.0.0)
Requires-Dist: comtypes (>=1.1.14,<2.0.0) ; sys_platform == "win32"
Requires-Dist: pyaudio (>=0.2.12,<0.3.0)
Requires-Dist: pyclip (>=0.7.0,<0.8.0)
Requires-Dist: pydantic (>=1.10.2,<2.0.0)
Requires-Dist: pywin32 (>=305,<306) ; sys_platform == "win32"
Requires-Dist: requests (>=2.28.1,<3.0.0)
Project-URL: Bug Tracker, https://github.com/willforde/willspeek/issues
Project-URL: Repository, https://github.com/willforde/willspeek.git
Description-Content-Type: text/markdown

# WillSpeak - Work in Progress
Python Text to Speach using Microsoft Sapi5 with a server/client model.

# Progress update
The core functionality is now working, and is ready for testing.
Some cleanup is still required, but it works.
Only supports SAPI5 for now. More to come in the future.

# Info
I created this project as a way to have good TTS on linux, because TTS on linux at the moment is dreadful.
For a long time I wanted to switch to linux, but I needed a good linux TTS software but could not find one.
So I decided to create this project to interface with the windows SAPI5 TTS engine.

How it works is by running this software in server mode on a Windows machine. 
Then configure the linux client to communicate with that Windows TTS server.
The client will monitor for text that was copied to the clipboard and converts the text into speech.

# Usage
This software has 2 different operational modes, "Local" & "Server/Client". If the TTS engine that you have selected 
works natively on your operating system, Then you can use Local mode. e.g. SAPI5 is native to windows, so you can use
Local mode on Windows when using SAPI5. You should use Server/Client if you want to use SAPI5 on linux.
It requires python 3.10 or grater.

Install using pip
```shell
python3 -m pip install willspeak
```

Run locally on Windows
```shell
willspeak local
```

To run in server mode do.
```shell
willspeak server
```

And on the client machine run. "--addr" is the address of the server running the server component.
```shell
# 192.168.1.60 is just an example
willspeak client --addr=192.168.1.60
```

There is one last command that is used to stop any current speech.
```shell
willspeak stop
```

# TODO
* Use a string library to analyze and filter the text before converting.
* Setup prometheus metrics to track usage. This is useful if you wish to use a paid for TTS Service.
* Add support for other text to speech engines, like eSpeak.
* Add support for running the server component as a Windows service.

# Links
https://winaero.com/unlock-extra-voices-windows-10/

## Version
0.3.0

