Skip to content
A python slack client that plays sounds in response to "play blah.mp3" messages
Branch: master
Clone or download
Pull request Compare This branch is 19 commits ahead, 238 commits behind slackapi:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
_pytest add slackclient tests Mar 11, 2015
slackclient Fixed issue with read being passed directly to json.loads, in python3… Apr 10, 2015
.gitignore Implemented whitelist Jun 3, 2015
LICENSE.txt add license Dec 5, 2014 sorry nik Mar 4, 2015
requirements.txt add requirements file Dec 9, 2014 Made speak more permissive, fixed letitgo.mp3 sounds. Nov 24, 2015 Fixed yt-add-sound script to work from anywhere. Sep 16, 2015 Bot message parsing. Run script from anywhere. Fixed play-yt to work … Aug 21, 2015


A client for, that plays sound files on request e.g. play trololo.

This is designed to run on a box in your office hooked up to speakers. That way everyone in your slack channel can enjoy its magic.


This plugin implements the python-slackclient to listen to channels its in (or direct messages) and responds to requests to play sounds of the format:

play filename


Automatic w/ PyPI

$ sudo apt-get install python-dev
$ sudo pip install websocket
$ sudo pip install slackclient

You'll also need an audio player that can handle the format

$ player path/to/file.mp3

I recommend mpg123 because it 'just works' with mp3s. Alternatives are aplay, paplay, mplayer, etc.

$ sudo apt-get install mpg123


Note: You must obtain a token for the user/bot. You can find or generate these at the Slack API page. You also need to create the bot for that matter.

Put the token in a file called token.txt in the same directory as

Run the bot:

$ python

Chat with the bot directly, or post in a channel its a member of:

play rollout

Note: The default sounds were lifted directly from here: (thanks campfire!)

You can’t perform that action at this time.