mac-say 2019.4.13

macOS tts. 'say' python interface

Installation

$ [sudo] pip install mac-say

Functions

function	__doc__
mac_say.say(args, background=False)	run say with given args
mac_say.voices(lang=None)	return a list of installed voices (name, lang, description)
mac_say.gtts.mp3(lang, string)	create .mp3 file (if cache not exists) and return path
mac_say.gtts.say(lang, string)	creare .mp3 file and play it with afplay

Executable modules

usage	__doc__
python -m mac_say.gtts lang strings ...	create . mp3 file with Google Text-to-Speech and play it with afplay

Examples

>>> import mac_say
>>> mac_say.say("hello world")
>>> mac_say.say(["-f","file.txt","-v","Alex"])

voices list

>>> mac_say.voices("en")
[('Alex', 'en_US', 'Most people recognize me by my voice.'), ...]

background - add background=True

>>> mac_say.say("hello world",background=True)

Google Text-To-Speech

>>> mac_say.gtts.mp3("en","hello world")
/Users/username/Library/Caches/say/<hash>.mp3

>>> mac_say.gtts.say("en","hello world")

$ python -m mac_say.gtts "en" "hello world"

python-readme-generator