| 1 | = Skype plugin for BitlBee |
|---|
| 2 | Miklos Vajna <vmiklos@frugalware.org> |
|---|
| 3 | |
|---|
| 4 | == How to set it up |
|---|
| 5 | |
|---|
| 6 | - You need the BitlBee bzr branch: |
|---|
| 7 | |
|---|
| 8 | ---- |
|---|
| 9 | bzr branch http://code.bitlbee.org/bitlbee/ |
|---|
| 10 | ---- |
|---|
| 11 | |
|---|
| 12 | - You need to enable plugin support: |
|---|
| 13 | |
|---|
| 14 | ---- |
|---|
| 15 | http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch |
|---|
| 16 | ---- |
|---|
| 17 | |
|---|
| 18 | - To be able to do an install-dev: |
|---|
| 19 | |
|---|
| 20 | ---- |
|---|
| 21 | http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch |
|---|
| 22 | ---- |
|---|
| 23 | |
|---|
| 24 | - Now compile and install it: |
|---|
| 25 | |
|---|
| 26 | ---- |
|---|
| 27 | ./configure --prefix=/usr |
|---|
| 28 | make |
|---|
| 29 | make install install-dev |
|---|
| 30 | ---- |
|---|
| 31 | |
|---|
| 32 | - Get the plugin code: |
|---|
| 33 | |
|---|
| 34 | ---- |
|---|
| 35 | git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype |
|---|
| 36 | ---- |
|---|
| 37 | |
|---|
| 38 | - Compile and install it: |
|---|
| 39 | |
|---|
| 40 | ---- |
|---|
| 41 | make |
|---|
| 42 | cp skype.so /usr/lib/bitlbee |
|---|
| 43 | ---- |
|---|
| 44 | |
|---|
| 45 | - Start skyped (the tcp server): |
|---|
| 46 | |
|---|
| 47 | ---- |
|---|
| 48 | python skyped.py |
|---|
| 49 | ---- |
|---|
| 50 | |
|---|
| 51 | NOTE: It's important to start skyped on the same machine and using the same |
|---|
| 52 | user as you run Skype as it uses the session DBus for communication! |
|---|
| 53 | |
|---|
| 54 | - Start your IRC client, connect to BitlBee and add your account: |
|---|
| 55 | |
|---|
| 56 | ---- |
|---|
| 57 | account add skype <user> <pass> |
|---|
| 58 | account set 0/server localhost |
|---|
| 59 | ---- |
|---|
| 60 | |
|---|
| 61 | IMPORTANT: <user> should be your skype account name. This way you won't see |
|---|
| 62 | yourself joining to `&bitlbee`. |
|---|
| 63 | |
|---|
| 64 | NOTE: the <pass> option is not used currently. |
|---|
| 65 | |
|---|
| 66 | == What works |
|---|
| 67 | |
|---|
| 68 | - Download nicks and away statuses from Skype |
|---|
| 69 | |
|---|
| 70 | - Noticing joins / parts while we're connected |
|---|
| 71 | |
|---|
| 72 | - Sending messages |
|---|
| 73 | |
|---|
| 74 | - Receiving messages |
|---|
| 75 | |
|---|
| 76 | - skyped (the tcp daemon that is a gateway between Skype and tcp) |
|---|
| 77 | |
|---|
| 78 | - Error handling when skyped is not running and when it exists |
|---|
| 79 | |
|---|
| 80 | == What needs to be done (aka. TODO) |
|---|
| 81 | |
|---|
| 82 | - we can't ourselves join to &bitlbee (ignore such a message from skype) |
|---|
| 83 | |
|---|
| 84 | - mark received messages as read so that skype won't say there are unread messages |
|---|
| 85 | |
|---|
| 86 | - Away status changes (send / receive) |
|---|
| 87 | |
|---|
| 88 | - add/remove users, detect when somebody wants to add us (maybe detect when we're removed?) |
|---|
| 89 | |
|---|
| 90 | - maybe on account on/off, change our state from/to offline? so that we won't miss any message |
|---|
| 91 | |
|---|
| 92 | == I would like to have support for ... |
|---|
| 93 | |
|---|
| 94 | If something does not work and it's not in the TODO section, then please contact me! |
|---|
| 95 | |
|---|
| 96 | == Screenshots |
|---|
| 97 | |
|---|
| 98 | You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here]. |
|---|
| 99 | |
|---|
| 100 | // vim: ft=asciidoc |
|---|
