Awesome

WARNING

Microsoft has stated that they will be dropping support for the Skype desktop API. This adapter will likely stop working in the very near future (If it hasn't already... this change was slated for December 2013).

The adapter was always a hack at best, if you are looking to set up a bot for your company or community I would HIGHLY recommend using a network that better supports scripting such as Campfire or IRC.

Description

This is the Skype adapter for hubot that allows you to communicate with hubot through Skype.

Installation

Add hubot-skype as a dependency in your hubot's package.json (use this repository url git://github.com/netpro2k/hubot-skype.git as the version)
Install dependencies with npm install
Install Python dependency Skype4Py with pip or easy_install
Log into a Skype client on the same machine you are running hubot
Run hubot with bin/hubot -a skype

Usage

The Skype adapter works by communicating through a locally running Skype client. You need to create a Skype account for your bot, and log into it on a Skype client running on the same machine as hubot. When you first launch hubot with the Skype adapter, Skype will prompt you to allow for API permission. You must allow this before the bot will work.

OS Specific notes

Windows

On Windows, it's possible to communicate with Skype via native COM interface without installing Python (which is not preinstalled in this OS) but using edge.js (.NET adapter for Node.js).

So, if you don't have Python installed and target only Windows machines, you can try Skype4COM adapter.

Please not that you shouldn't use it if planning to run your script on other operating systems.

OSX

The current version of Skype4Py doesn't play nicely with the 64 bit version of python on OSX and would immediately cause a segmentation fault, but a workaround has been established in this repo using the arch command (see /src/python32bit for details).

If this built in workaround doesn't seem to work, you may need to force python to run in 32 bit mode by setting the environment variable VERSIONER_PYTHON_PREFER_32_BIT to true

Ex:

export VERSIONER_PYTHON_PREFER_32_BIT=yes
./hubot -a skype

Linux

If you would like to use a different transport type than the default (x11) you may set the HUBOT_SKYPE_TRANSPORT environment variable. Currently supported values are x11 amd dbus. More information on module page.

Contribute

Here's the most direct way to get your work merged into the project.

Fork the project
Clone down your fork
Create a feature branch
Hack away
If necessary, rebase your commits into logical chunks without errors
Push the branch up to your fork
Send a pull request for your branch