aboutsummaryrefslogtreecommitdiffstats
path: root/skype/README
blob: 57f1f949e6628d92da53acd21ff67d7d1dd4e268 (plain)
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
= Skype plugin for BitlBee
Miklos Vajna <vmiklos@frugalware.org>

== 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.

- You need the BitlBee bzr branch:

----
bzr branch http://code.bitlbee.org/bitlbee/
----

- You need to enable plugin support:

----
http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch
----

- To be able to do an install-dev:

----
http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch
----

- Now compile and install it:

----
./configure --prefix=/usr
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
cp skype.so /usr/lib/bitlbee
----

- Start skyped (the tcp server):

----
python skyped.py
----

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

== What needs to be done (aka. TODO)

- add/remove users, detect when somebody wants to add us

- Due to some API limitations, I have no idea how to change status. This affects:
  * When you `/away`, Skype will be still show `Online`
  * When you `account off`, Skype will not set status to `Offline`
  * When you `account on`, Skype will not set status to `Online`

== I would like to have support for ...

If something does not work and it's not in the TODO section, then please contact me!

== Screenshots

You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here].

// vim: ft=asciidoc