Leverage the macOS `say` command into you scripts
Project description
macos_speech
Ever wanted to leverage the macOS builtin speech synthesis directly into python ? Or just make your code to talk...
With the Python macos_speech package you can do it in a pythonic way. Easy and zen.
Getting Started:
Installation
pip install macos_speech
git clone https://github.com/tibOin/macos_speech.git
cd macos_speech
pip install .
Requirements
macOS 10.x or for oldest OS X
For now, this package only works on Python >= 2.6 and Python >= 3.6.x
Only tested on Python 2.7.10 and 3.7.2.
Basic usage
from macos_speech import Synthesizer # or from macos_speech.macos_speech import Synthesizer
speaker = Synthesizer(voice='Alex', device='Built-in')
speaker.text = """How my God! I can make my python code to talk!
And I can even send multiple lines! Awesome.
"""
speaker.talk()
Some informations
from macos_speech import Synthesizer
speaker = Synthesizer()
print '''Voices:
NAME LANGUAGE DESCRIPTION
'''
for voice in speaker.voices:
print '{} {} {}'.format(voice.name, voice.lang, voice.desc)
print ''
print 'Audio devices:'
for device in speaker.devices:
print 'ID: {}, NAME: {}'.format(device.id, device.name)
print ''
print '''Output file possible formats:
ID NAME FILE_EXT DATA_FORMATS BIT_RATES
'''
for format in speaker.formats:
print '{} {} ({}) [{}] [{}]'.format(format.id, format.name,
','.join(format.exts),
','.join(format.formats),
','.join(format.bitrates))
Synthesizer Properties
from macos_speech import Synthesizer
synthe = Synthesizer()
# Helper properties
synthe.devices
synthe.voices
synthe.formats
# Configuration properties
# File IO (takes absolute pathes strings)
synthe.infile # A file containing text to say (mutually exclusive with self.text - high priority)
synthe.outfile # The output audio file (default should be 'output.aiff'
# but you can specify file and data formats)
# Simple configs (takes strings)
synthe.rate # The speech rate
synthe.quality # The audio quality (between 0 and 127 both included)
synthe.text # The text to say (mutually exclusive with self.infile - low priority)
# Pythonified configs (takes macos_speech.CustomClasses)
synthe.format # The audio output file/data format : macos_speech.AudioFormat
# (Works only with self.outfile populated)
synthe.device # The audio output device : macos_speech.AudioDevice
# (or 'name' or 'id' on Python 3)
# (Only used if no self.outfile)
synthe.voice # The voice to use : macos_speech.Voice
# (or 'name' on Python 3)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
macos_speech-1.0b1.tar.gz
(4.5 kB
view hashes)
Built Distribution
Close
Hashes for macos_speech-1.0b1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a3935f8aef2e3b844fdff8c1d3f7200d60991cf5c3235b3e55b29d030e3b2c30 |
|
MD5 | 5067f4066aeac60bb256dda232a92a1c |
|
BLAKE2b-256 | 612fd49574978ff14baa77004a63b6774027886f340ef4790d459e181574dc2c |