source: skype/README @ 3953172

Last change on this file since 3953172 was 0ac1b3e0, checked in by VMiklos <vmiklos@…>, at 2007-08-21T19:20:16Z

more todo

  • Property mode set to 100644
File size: 3.9 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`.
25
26- If you happen to be a happy Frugalware user, you can install the `bitlbee`
27  and `bitlbee-skype` packages from
28  http://ftp.frugalware.org/pub/other/people/vmiklos/bmf/[my repo].
29
30- You need the BitlBee bzr branch:
31
32----
33bzr branch http://code.bitlbee.org/bitlbee/
34----
35
36- You need some additional patches:
37
38----
39http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch
40http://frugalware.org/~vmiklos/patches/bitlbee-global-conf-may-be-null.patch
41http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch
42http://frugalware.org/~vmiklos/patches/bitlbee-more-verbose-on-plugin-errors.patch
43----
44
45(Yes, I submitted all of them to the
46http://bugs.bitlbee.org/bitlbee/[bugtracker] already.)
47
48- Now compile and install it:
49
50----
51./configure
52make
53make install install-dev
54----
55
56- Get the plugin code:
57
58----
59git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype
60----
61
62- Compile and install it:
63
64----
65make prepare
66./configure
67make
68make install
69----
70
71- Start Skype and `skyped` (the tcp server):
72
73----
74skype
75skyped
76----
77
78NOTE: It's important to start skyped on the same machine and using the same
79user as you run Skype as it uses the session DBus for communication!
80
81- Start your IRC client, connect to BitlBee and add your account:
82
83----
84account add skype <user> <pass>
85account set 0/server localhost
86----
87
88IMPORTANT: <user> should be your skype account name. This way you won't see
89yourself joining to `&bitlbee`.
90
91NOTE: the <pass> option is not used currently.
92
93== What works
94
95- Download nicks and away statuses from Skype
96
97- Noticing joins / parts while we're connected
98
99- Sending messages
100
101- Receiving messages
102
103- Receiving away status changes
104
105- `skyped` (the tcp daemon that is a gateway between Skype and tcp)
106
107- Error handling when `skyped` is not running and when it exits
108
109- Marking received messages as seen so that Skype won't say there are unread messages
110
111- Adding / removing contacts
112
113- Set away state when you do a `/away`.
114
115- When you `account off`, Skype will set status to `Offline`
116
117- When you `account on`, Skype will set status to `Online`
118
119- Detect when somebody wants to add you and ask for confirmation
120
121== What needs to be done (aka. TODO)
122
123- `--daemon` option for `skyped`
124
125- document how do I run skype on a server using vnc
126
127== I would like to have support for ...
128
129If something does not work and it's not in the TODO section, then please contact me!
130
131== Known bugs
132
133- Sometimes when you get a lot of messages in a short time, some of the
134  messages are dropped. This is a known bug in Skype itself as of version
135  1.4.0.99
136  (http://forum.skype.com/index.php?s=&showtopic=94545&view=findpost&p=431710[link]).
137
138== Screenshots
139
140You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here].
141
142== Changelog
143
144You can reach the Changelog link:Changelog[here].
145
146// vim: ft=asciidoc
Note: See TracBrowser for help on using the repository browser.