1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
= Skype plugin for BitlBee
Miklos Vajna <vmiklos@frugalware.org>
== Status
One day I browsed the BitlBee bugtracker and found
http://bugs.bitlbee.org/bitlbee/ticket/82[this] ticket. Then after a while I
returned and saw that it was still open. So I wrote it. Not a big deal, I wrote
it in two days or so (and not because I'm a genius or anything ;-) ). I think
it's pretty stable, but it needs wider testing. Also see the 'Known bugs'
section, I really hope those random hangups will be fixed soon by Skype.
Oh, before I forget. I'm not a wizard, the Skype API documentation is
https://developer.skype.com/Docs/ApiDoc[here] if you're interested.
== How to set it up
Before you start. The setup is the following: BitlBee can't connect directly to
Skype servers (the company's ones). It needs a running Skype client to do so.
In fact BitlBee will connect to `skyped` (a tcp server, provided in this
package) and `skyped` will connecto to your Skype client.
NOTE: The order is important. First you have to start Skype. Then `skyped` can
connect to it, finally BitlBee can connect to `skyped`. (In fact `skyped`
automatically reconnect if you restart Skype.)
- If you happen to be a happy Frugalware user, you can install the `bitlbee`
and `bitlbee-skype` packages from
http://ftp.frugalware.org/pub/other/people/vmiklos/bmf/[my repo].
- You need the BitlBee bzr branch:
----
bzr branch http://code.bitlbee.org/bitlbee/
----
- You need some additional patches:
----
http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch
http://frugalware.org/~vmiklos/patches/bitlbee-global-conf-may-be-null.patch
http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch
http://frugalware.org/~vmiklos/patches/bitlbee-more-verbose-on-plugin-errors.patch
----
(Yes, I submitted all of them to the
http://bugs.bitlbee.org/bitlbee/[bugtracker] already.)
- Now compile and install it:
----
./configure
make
make install install-dev
----
- Get the plugin code:
----
git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype
----
- Compile and install it:
----
make prepare
./configure
make
make install
----
- Start Skype and `skyped` (the tcp server):
----
skype
skyped
----
NOTE: It's important to start skyped on the same machine and using the same
user as you run Skype as it uses the session DBus for communication!
- Start your IRC client, connect to BitlBee and add your account:
----
account add skype <user> <pass>
account set 0/server localhost
----
IMPORTANT: <user> should be your skype account name. This way you won't see
yourself joining to `&bitlbee`.
NOTE: the <pass> option is not used currently.
== What works
- Download nicks and away statuses from Skype
- Noticing joins / parts while we're connected
- Sending messages
- Receiving messages
- Receiving away status changes
- `skyped` (the tcp daemon that is a gateway between Skype and tcp)
- Error handling when `skyped` is not running and when it exits
- Marking received messages as seen so that Skype won't say there are unread messages
- Adding / removing contacts
- Set away state when you do a `/away`.
- When you `account off`, Skype will set status to `Offline`
- When you `account on`, Skype will set status to `Online`
- Detect when somebody wants to add you and ask for confirmation
== What needs to be done (aka. TODO)
- document how do I run skype on a server using vnc
== I would like to have support for ...
If something does not work and it's not in the TODO section, then please contact me!
== Known bugs
- Sometimes when you get a lot of messages in a short time, some of the
messages are dropped. This is a known bug in Skype itself as of version
1.4.0.99
(http://forum.skype.com/index.php?s=&showtopic=94545&view=findpost&p=431710[link]).
== Screenshots
You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here].
== Changelog
You can reach the Changelog link:Changelog[here].
// vim: ft=asciidoc
|
