A self contained python-based server that allows remote usage of OS X's text-to-speech abilities.
Python Shell
Pull request Compare This branch is 33 commits ahead, 2 commits behind dz:master.
Failed to load latest commit information.
README.rst Add port scanner Apr 6, 2011
bootstrap.sh update location of raw file Aug 1, 2011
finder.py lower timeout to 5s Apr 25, 2011
voices.py Remove proctitle renaming Apr 15, 2011



What is it?

voices.py is a self-contained python script that starts a webserver that listens on a user-entered IP and port that allows a visitor to remotely send text-to-speech commands on OS X machines.

What is it good for?

The machines that coworkers would leave unattended and unlocked is the primary impetus. If you find such a machine, do the following:

  1. Open up Terminal.app

  2. Type the following:

    curl -L -O https://github.com/dcramer/voices.py/raw/master/bootstrap.sh && sh bootstrap.sh && rm bootstrap.sh
  3. In a browser, go to the entered IP and port number. For example, You should be presented with a page that has a select box and a text box. Simply choose a voice and enter a message.

  4. Press "Say".

  5. Profit.

Why do I want to do this?

For hilarity! Suggestions:

  1. Use the "Whisper" voice and have the target's computer whisper "kill all humans" every 30 minutes or so.
  2. Use "Cellos" with a suitably catchy lyric.
  3. Use "Trinoids" and make the computer say: "Please wait. Calculating. Boop dee boop dee boop dee boop dee boop dee boop."


Mac OS X, obviously. And also Python.

Usage details

Without an argument, voices.py will attempt to autodiscover your IP and automatically use 2046 as the port:

$ python voices.py
Explicit IP and port not entered.  Attempted to autodiscover IP address.
Serving on

With an argument, voices.py will use the IP and port you entered. Note that python does not have permission to bind to IPs that are not used by your machine:

$ python voices.py
Serving on

For a short help, do use --help:

$ python voices.py --help
Usage: python voices.py x.x.x.x:port