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