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.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_pytest add slackclient tests Mar 11, 2015
doc/examples
slackclient Fixed issue with read being passed directly to json.loads, in python3… Apr 10, 2015
sounds
.gitignore Implemented whitelist Jun 3, 2015
LICENSE.txt add license Dec 5, 2014
README.md
__init__.py sorry nik Mar 4, 2015
requirements.txt add requirements file Dec 9, 2014
setup.py
sounds.py Made speak more permissive, fixed letitgo.mp3 sounds. Nov 24, 2015
yt-add-sound.sh Fixed yt-add-sound script to work from anywhere. Sep 16, 2015
yt-audio.sh Bot message parsing. Run script from anywhere. Fixed play-yt to work … Aug 21, 2015

README.md

slack-sounds

A client for Slack.com, 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.

Overview

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

Installation

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

Usage

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 sounds.py

Run the bot:

$ python sounds.py

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: http://www.emoji-cheat-sheet.com/ (thanks campfire!)

You can’t perform that action at this time.