Skip to content
A self contained python-based server that allows remote usage of OS X's text-to-speech abilities.
Python Shell
Find file
Pull request Compare This branch is 33 commits ahead, 2 commits behind dz:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


What is it? 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

  2. Type the following:

    curl -L -O && sh && rm
  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, will attempt to autodiscover your IP and automatically use 2046 as the port:

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

With an argument, 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
Serving on

For a short help, do use --help:

$ python --help
Usage: python x.x.x.x:port
Something went wrong with that request. Please try again.