source: skype/README @ f35022f

Last change on this file since f35022f was 23b84e1, checked in by VMiklos <vmiklos@…>, at 2007-08-22T00:22:52Z

document the vnc server setup

  • Property mode set to 100644
File size: 4.8 KB
Line 
1= Skype plugin for BitlBee
2Miklos Vajna <vmiklos@frugalware.org>
3
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
8returned and saw that it was still open. So I wrote it. Not a big deal, I wrote
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
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
16== How to set it up
17
18Before you start. The setup is the following: BitlBee can't connect directly to
19Skype servers (the company's ones). It needs a running Skype client to do so.
20In fact BitlBee will connect to `skyped` (a tcp server, provided in this
21package) and `skyped` will connecto to your Skype client.
22
23NOTE: The order is important. First you have to start Skype. Then `skyped` can
24connect to it, finally BitlBee can connect to `skyped`. (In fact `skyped`
25automatically reconnect if you restart Skype.)
26
27- If you happen to be a happy Frugalware user, you can install the `bitlbee`
28  and `bitlbee-skype` packages from
29  http://ftp.frugalware.org/pub/other/people/vmiklos/bmf/[my repo].
30
31- You need the BitlBee bzr branch:
32
33----
34bzr branch http://code.bitlbee.org/bitlbee/
35----
36
37- You need some additional patches:
38
39----
40http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch
41http://frugalware.org/~vmiklos/patches/bitlbee-global-conf-may-be-null.patch
42http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch
43http://frugalware.org/~vmiklos/patches/bitlbee-more-verbose-on-plugin-errors.patch
44----
45
46(Yes, I submitted all of them to the
47http://bugs.bitlbee.org/bitlbee/[bugtracker] already.)
48
49- Now compile and install it:
50
51----
52./configure
53make
54make install install-dev
55----
56
57- Get the plugin code:
58
59----
60git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype
61----
62
63- Compile and install it:
64
65----
66make prepare
67./configure
68make
69make install
70----
71
72- Start Skype and `skyped` (the tcp server):
73
74----
75skype
76skyped
77----
78
79NOTE: It's important to start skyped on the same machine and using the same
80user as you run Skype as it uses the session DBus for communication!
81
82- Start your IRC client, connect to BitlBee and add your account:
83
84----
85account add skype <user> <pass>
86account set 0/server localhost
87----
88
89IMPORTANT: <user> should be your skype account name. This way you won't see
90yourself joining to `&bitlbee`.
91
92NOTE: the <pass> option is not used currently.
93
94== Setting up Skype in a VNC server (optional)
95
96Optionally, if you want to run Skype on a server, you might want to setup up
97a VNC server as well. I used `tightvnc` but probably other VNC servers will
98work, too.
99
100First run
101
102----
103vncpasswd ~/.vnc/passwd
104----
105
106and create a password. You will need it at least once.
107
108Now create `~/.vnc/xstartup` with the following contents:
109
110----
111#!/bin/sh
112
113/usr/bin/sleep 1
114/usr/bin/skype &
115/usr/bin/sleep 5
116/usr/sbin/skyped
117----
118
119Then start the server:
120
121----
122vncserver
123----
124
125Then connect to it, and set up Skype (username, password, enable autologin, and
126allow the `SkypeApiPythonShell` client when Skype asks about it).
127
128== What works
129
130- Download nicks and away statuses from Skype
131
132- Noticing joins / parts while we're connected
133
134- Sending messages
135
136- Receiving messages
137
138- Receiving away status changes
139
140- `skyped` (the tcp daemon that is a gateway between Skype and tcp)
141
142- Error handling when `skyped` is not running and when it exits
143
144- Marking received messages as seen so that Skype won't say there are unread messages
145
146- Adding / removing contacts
147
148- Set away state when you do a `/away`.
149
150- When you `account off`, Skype will set status to `Offline`
151
152- When you `account on`, Skype will set status to `Online`
153
154- Detect when somebody wants to add you and ask for confirmation
155
156== What needs to be done (aka. TODO)
157
158- Empty? No, this is not possible. I need more testers! :-)
159
160== I would like to have support for ...
161
162If something does not work and it's not in the TODO section, then please
163contact me!
164
165In fact, of course, I wrote this documentation after figured out how to do this
166setup, so maybe I left out some steps. If you needed 'any' additional tricks,
167then it would be nice to include them here.
168
169== Known bugs
170
171- Sometimes when you get a lot of messages in a short time, some of the
172  messages are dropped. This is a known bug in Skype itself as of version
173  1.4.0.99
174  (http://forum.skype.com/index.php?s=&showtopic=94545&view=findpost&p=431710[link]).
175
176== Screenshots
177
178You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here].
179
180== Changelog
181
182You can reach the Changelog link:Changelog[here].
183
184// vim: ft=asciidoc
Note: See TracBrowser for help on using the repository browser.