[0c60f96] | 1 | = Skype plugin for BitlBee |
---|
| 2 | Miklos Vajna <vmiklos@frugalware.org> |
---|
[afe221f] | 3 | |
---|
[56e4ac4] | 4 | == Status |
---|
| 5 | |
---|
| 6 | One day I browsed the BitlBee bugtracker and found |
---|
| 7 | http://bugs.bitlbee.org/bitlbee/ticket/82[this] ticket. Then after a while I |
---|
[56b56478] | 8 | returned and saw that it was still open. So I wrote it. Not a big deal, I wrote |
---|
[56e4ac4] | 9 | it in two days or so (and not because I'm a genius or anything ;-) ). I think |
---|
| 10 | it's pretty stable, but it needs wider testing. Also see the 'Known bugs' |
---|
| 11 | section, I really hope those random hangups will be fixed soon by Skype. |
---|
| 12 | |
---|
[75742cc] | 13 | Oh, before I forget. I'm not a wizard, the Skype API documentation is |
---|
| 14 | https://developer.skype.com/Docs/ApiDoc[here] if you're interested. |
---|
| 15 | |
---|
[22d97b4] | 16 | == Requirements |
---|
| 17 | |
---|
| 18 | * Skype 1.4.0.99. 1.4.0.74 did *not* work for me. |
---|
| 19 | * bitlbee-dev >= rev245. Previous versions need patching. |
---|
| 20 | * Skype4Py >= 0.9.28.1. Previous versions uses DBus by default. |
---|
| 21 | * Python 2.5. Skype4Py does not work with 2.4. |
---|
| 22 | * pygobject |
---|
| 23 | |
---|
[9e03e55] | 24 | == How to set it up |
---|
[afe221f] | 25 | |
---|
[751b149] | 26 | Before you start. The setup is the following: BitlBee can't connect directly to |
---|
| 27 | Skype servers (the company's ones). It needs a running Skype client to do so. |
---|
| 28 | In fact BitlBee will connect to `skyped` (a tcp server, provided in this |
---|
| 29 | package) and `skyped` will connecto to your Skype client. |
---|
| 30 | |
---|
[7e4f0ca1] | 31 | NOTE: The order is important. First you have to start Skype. Then `skyped` can |
---|
[64f8b8ea] | 32 | connect to it, finally BitlBee can connect to `skyped`. (In fact `skyped` |
---|
| 33 | automatically reconnect if you restart Skype.) |
---|
[7e4f0ca1] | 34 | |
---|
[11eed8f] | 35 | - If you happen to be a happy Frugalware user, you can install the `bitlbee` |
---|
| 36 | and `bitlbee-skype` packages from |
---|
| 37 | http://ftp.frugalware.org/pub/other/people/vmiklos/bmf/[my repo]. |
---|
| 38 | |
---|
[afe221f] | 39 | - You need the BitlBee bzr branch: |
---|
| 40 | |
---|
[0c60f96] | 41 | ---- |
---|
[afe221f] | 42 | bzr branch http://code.bitlbee.org/bitlbee/ |
---|
[0c60f96] | 43 | ---- |
---|
[afe221f] | 44 | |
---|
[9c90281] | 45 | NOTE: You no longer need additional patches, as of revision 245. |
---|
[b8b0bfd] | 46 | |
---|
[afe221f] | 47 | - Now compile and install it: |
---|
| 48 | |
---|
[0c60f96] | 49 | ---- |
---|
[8e3058b] | 50 | ./configure |
---|
[afe221f] | 51 | make |
---|
| 52 | make install install-dev |
---|
[0c60f96] | 53 | ---- |
---|
[afe221f] | 54 | |
---|
| 55 | - Get the plugin code: |
---|
| 56 | |
---|
[0c60f96] | 57 | ---- |
---|
[99426f0] | 58 | git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype/.git |
---|
[0c60f96] | 59 | ---- |
---|
[afe221f] | 60 | |
---|
[b8351a2] | 61 | (Or you can use the tarballs below, see the Changelog about what |
---|
| 62 | features/bugfixes will you miss in this case). |
---|
| 63 | |
---|
[afe221f] | 64 | - Compile and install it: |
---|
| 65 | |
---|
[0c60f96] | 66 | ---- |
---|
[8e3058b] | 67 | make prepare |
---|
| 68 | ./configure |
---|
[afe221f] | 69 | make |
---|
[8e3058b] | 70 | make install |
---|
[0c60f96] | 71 | ---- |
---|
[afe221f] | 72 | |
---|
[c15f71a] | 73 | - Install http://skype4py.sourceforge.net/[Skype4Py]. |
---|
| 74 | |
---|
| 75 | (You may remember that previous versions of `skyped` did not require this |
---|
| 76 | package. This because it now uses the X11 interface of Skype (because the |
---|
| 77 | previously used DBus interface had |
---|
| 78 | http://forum.skype.com/index.php?s=&showtopic=94545&view=findpost&p=431710[known |
---|
| 79 | problems]), but I wanted to prevent a large code duplication from that project. |
---|
| 80 | In addition it then no longer requires the `dbus-python` package, just |
---|
| 81 | `pygobject`.) |
---|
| 82 | |
---|
[2fcad6e] | 83 | - Start Skype and `skyped` (the tcp server): |
---|
[afe221f] | 84 | |
---|
[0c60f96] | 85 | ---- |
---|
[2fcad6e] | 86 | skype |
---|
| 87 | skyped |
---|
[0c60f96] | 88 | ---- |
---|
[ba20c39] | 89 | |
---|
| 90 | NOTE: It's important to start skyped on the same machine and using the same |
---|
| 91 | user as you run Skype as it uses the session DBus for communication! |
---|
[afe221f] | 92 | |
---|
[7338d59] | 93 | - Start your IRC client, connect to BitlBee and add your account: |
---|
| 94 | |
---|
| 95 | ---- |
---|
| 96 | account add skype <user> <pass> |
---|
| 97 | account set 0/server localhost |
---|
| 98 | ---- |
---|
| 99 | |
---|
| 100 | IMPORTANT: <user> should be your skype account name. This way you won't see |
---|
| 101 | yourself joining to `&bitlbee`. |
---|
| 102 | |
---|
| 103 | NOTE: the <pass> option is not used currently. |
---|
| 104 | |
---|
[23b84e1] | 105 | == Setting up Skype in a VNC server (optional) |
---|
| 106 | |
---|
| 107 | Optionally, if you want to run Skype on a server, you might want to setup up |
---|
| 108 | a VNC server as well. I used `tightvnc` but probably other VNC servers will |
---|
| 109 | work, too. |
---|
| 110 | |
---|
| 111 | First run |
---|
| 112 | |
---|
| 113 | ---- |
---|
| 114 | vncpasswd ~/.vnc/passwd |
---|
| 115 | ---- |
---|
| 116 | |
---|
| 117 | and create a password. You will need it at least once. |
---|
| 118 | |
---|
| 119 | Now create `~/.vnc/xstartup` with the following contents: |
---|
| 120 | |
---|
| 121 | ---- |
---|
| 122 | #!/bin/sh |
---|
| 123 | |
---|
[19b805c] | 124 | sleep 1 |
---|
| 125 | skype & |
---|
| 126 | sleep 5 |
---|
| 127 | skyped |
---|
[23b84e1] | 128 | ---- |
---|
| 129 | |
---|
[57087df] | 130 | Adjust the permissions: |
---|
| 131 | |
---|
| 132 | ---- |
---|
| 133 | chmod +x ~/.vnc/xstartup |
---|
| 134 | ---- |
---|
| 135 | |
---|
[23b84e1] | 136 | Then start the server: |
---|
| 137 | |
---|
| 138 | ---- |
---|
| 139 | vncserver |
---|
| 140 | ---- |
---|
| 141 | |
---|
| 142 | Then connect to it, and set up Skype (username, password, enable autologin, and |
---|
| 143 | allow the `SkypeApiPythonShell` client when Skype asks about it). |
---|
| 144 | |
---|
[9e03e55] | 145 | == What works |
---|
[b6d26ac] | 146 | |
---|
[adce2de] | 147 | - Download nicks and away statuses from Skype |
---|
[b6d26ac] | 148 | |
---|
[39a0d64] | 149 | - Noticing joins / parts while we're connected |
---|
| 150 | |
---|
[93ece66] | 151 | - Sending messages |
---|
| 152 | |
---|
[8dd21bb] | 153 | - Receiving messages |
---|
| 154 | |
---|
[72f697b] | 155 | - Receiving away status changes |
---|
| 156 | |
---|
[62bb4e4] | 157 | - `skyped` (the tcp daemon that is a gateway between Skype and tcp) |
---|
[ed2e37f] | 158 | |
---|
[62bb4e4] | 159 | - Error handling when `skyped` is not running and when it exits |
---|
[afe221f] | 160 | |
---|
[62bb4e4] | 161 | - Marking received messages as seen so that Skype won't say there are unread messages |
---|
[440665b] | 162 | |
---|
[6627d92] | 163 | - Adding / removing contacts |
---|
| 164 | |
---|
[23411c6] | 165 | - Set away state when you do a `/away`. |
---|
| 166 | |
---|
[d3cbd17] | 167 | - When you `account off`, Skype will set status to `Offline` |
---|
[348a3a2] | 168 | |
---|
[d3cbd17] | 169 | - When you `account on`, Skype will set status to `Online` |
---|
[348a3a2] | 170 | |
---|
[d3cbd17] | 171 | - Detect when somebody wants to add you and ask for confirmation |
---|
[8dd21bb] | 172 | |
---|
[d3cbd17] | 173 | == What needs to be done (aka. TODO) |
---|
[93ece66] | 174 | |
---|
[b7f7100] | 175 | - Group chat support. Sadly I'm not too motivated to implement this at the |
---|
| 176 | moment. |
---|
[0ac1b3e0] | 177 | |
---|
[846ceffb] | 178 | - Add a question callback for calls. |
---|
| 179 | |
---|
[0c60f96] | 180 | == I would like to have support for ... |
---|
| 181 | |
---|
[23b84e1] | 182 | If something does not work and it's not in the TODO section, then please |
---|
| 183 | contact me! |
---|
| 184 | |
---|
| 185 | In fact, of course, I wrote this documentation after figured out how to do this |
---|
| 186 | setup, so maybe I left out some steps. If you needed 'any' additional tricks, |
---|
| 187 | then it would be nice to include them here. |
---|
[afe221f] | 188 | |
---|
[f78f949] | 189 | == Known bugs |
---|
| 190 | |
---|
[c15f71a] | 191 | - None at this time. |
---|
[f78f949] | 192 | |
---|
[0c60f96] | 193 | == Screenshots |
---|
| 194 | |
---|
| 195 | You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here]. |
---|
[ddd3502] | 196 | |
---|
[a60c3c2] | 197 | == Changelog |
---|
| 198 | |
---|
| 199 | You can reach the Changelog link:Changelog[here]. |
---|
| 200 | |
---|
[0c60f96] | 201 | // vim: ft=asciidoc |
---|