source: skype/README @ 8b3beef

Last change on this file since 8b3beef was 80d9004, checked in by VMiklos <vmiklos@…>, at 2007-09-05T14:40:09Z

users should try git before reporting bugs

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