source: skype/README @ 7e4f0ca1

Last change on this file since 7e4f0ca1 was 7e4f0ca1, checked in by VMiklos <vmiklos@…>, at 2007-08-20T20:59:58Z

more docs

  • Property mode set to 100644
File size: 2.7 KB
Line 
1= Skype plugin for BitlBee
2Miklos Vajna <vmiklos@frugalware.org>
3
4== How to set it up
5
6Before you start. The setup is the following: BitlBee can't connect directly to
7Skype servers (the company's ones). It needs a running Skype client to do so.
8In fact BitlBee will connect to `skyped` (a tcp server, provided in this
9package) and `skyped` will connecto to your Skype client.
10
11NOTE: The order is important. First you have to start Skype. Then `skyped` can
12connect to it, finally BitlBee can connect to `skyped`.
13
14- You need the BitlBee bzr branch:
15
16----
17bzr branch http://code.bitlbee.org/bitlbee/
18----
19
20- You need to enable plugin support:
21
22----
23http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch
24----
25
26- To be able to do an install-dev:
27
28----
29http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch
30----
31
32- Now compile and install it:
33
34----
35./configure --prefix=/usr
36make
37make install install-dev
38----
39
40- Get the plugin code:
41
42----
43git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype
44----
45
46- Compile and install it:
47
48----
49make
50cp skype.so /usr/lib/bitlbee
51----
52
53- Start skyped (the tcp server):
54
55----
56python skyped.py
57----
58
59NOTE: It's important to start skyped on the same machine and using the same
60user as you run Skype as it uses the session DBus for communication!
61
62- Start your IRC client, connect to BitlBee and add your account:
63
64----
65account add skype <user> <pass>
66account set 0/server localhost
67----
68
69IMPORTANT: <user> should be your skype account name. This way you won't see
70yourself joining to `&bitlbee`.
71
72NOTE: the <pass> option is not used currently.
73
74== What works
75
76- Download nicks and away statuses from Skype
77
78- Noticing joins / parts while we're connected
79
80- Sending messages
81
82- Receiving messages
83
84- Receiving away status changes
85
86- `skyped` (the tcp daemon that is a gateway between Skype and tcp)
87
88- Error handling when `skyped` is not running and when it exits
89
90- Marking received messages as seen so that Skype won't say there are unread messages
91
92- Adding / removing contacts
93
94== What needs to be done (aka. TODO)
95
96- detect when somebody wants to add us
97
98- Due to some API limitations, I have no idea how to change status. This affects:
99  * When you `/away`, Skype will be still show `Online`
100  * When you `account off`, Skype will not set status to `Offline`
101  * When you `account on`, Skype will not set status to `Online`
102
103== I would like to have support for ...
104
105If something does not work and it's not in the TODO section, then please contact me!
106
107== Screenshots
108
109You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here].
110
111== Changelog
112
113You can reach the Changelog link:Changelog[here].
114
115// vim: ft=asciidoc
Note: See TracBrowser for help on using the repository browser.