source: skype/README @ b8b0bfd

Last change on this file since b8b0bfd was b8b0bfd, checked in by VMiklos <vmiklos@…>, at 2007-08-21T17:39:43Z

mention a bit more patches

  • Property mode set to 100644
File size: 3.0 KB
RevLine 
[0c60f96]1= Skype plugin for BitlBee
2Miklos Vajna <vmiklos@frugalware.org>
[afe221f]3
[9e03e55]4== How to set it up
[afe221f]5
[751b149]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
[7e4f0ca1]11NOTE: The order is important. First you have to start Skype. Then `skyped` can
12connect to it, finally BitlBee can connect to `skyped`.
13
[afe221f]14- You need the BitlBee bzr branch:
15
[0c60f96]16----
[afe221f]17bzr branch http://code.bitlbee.org/bitlbee/
[0c60f96]18----
[afe221f]19
[b8b0bfd]20- You need some additional patches:
[afe221f]21
[0c60f96]22----
[afe221f]23http://frugalware.org/~vmiklos/patches/bitlbee-configure-plugins.patch
[b8b0bfd]24http://frugalware.org/~vmiklos/patches/bitlbee-global-conf-may-be-null.patch
[afe221f]25http://frugalware.org/~vmiklos/patches/bitlbee-makefile-headers.patch
[b8b0bfd]26http://frugalware.org/~vmiklos/patches/bitlbee-more-verbose-on-plugin-errors.patch
[0c60f96]27----
[afe221f]28
[b8b0bfd]29(Yes, I submitted all of them to the
30http://bugs.bitlbee.org/bitlbee/[bugtracker] already.)
31
[afe221f]32- Now compile and install it:
33
[0c60f96]34----
[afe221f]35./configure --prefix=/usr
36make
37make install install-dev
[0c60f96]38----
[afe221f]39
40- Get the plugin code:
41
[0c60f96]42----
[afe221f]43git clone http://ftp.frugalware.org/pub/other/people/vmiklos/bitlbee-skype
[0c60f96]44----
[afe221f]45
46- Compile and install it:
47
[0c60f96]48----
[afe221f]49make
50cp skype.so /usr/lib/bitlbee
[0c60f96]51----
[afe221f]52
[ed2e37f]53- Start skyped (the tcp server):
[afe221f]54
[0c60f96]55----
[ba20c39]56python skyped.py
[0c60f96]57----
[ba20c39]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!
[afe221f]61
[7338d59]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
[9e03e55]74== What works
[b6d26ac]75
[adce2de]76- Download nicks and away statuses from Skype
[b6d26ac]77
[39a0d64]78- Noticing joins / parts while we're connected
79
[93ece66]80- Sending messages
81
[8dd21bb]82- Receiving messages
83
[72f697b]84- Receiving away status changes
85
[62bb4e4]86- `skyped` (the tcp daemon that is a gateway between Skype and tcp)
[ed2e37f]87
[62bb4e4]88- Error handling when `skyped` is not running and when it exits
[afe221f]89
[62bb4e4]90- Marking received messages as seen so that Skype won't say there are unread messages
[440665b]91
[6627d92]92- Adding / removing contacts
93
[23411c6]94- Set away state when you do a `/away`.
95
[d3cbd17]96- When you `account off`, Skype will set status to `Offline`
[348a3a2]97
[d3cbd17]98- When you `account on`, Skype will set status to `Online`
[348a3a2]99
[d3cbd17]100- Detect when somebody wants to add you and ask for confirmation
[8dd21bb]101
[d3cbd17]102== What needs to be done (aka. TODO)
[93ece66]103
[0c60f96]104== I would like to have support for ...
105
[afe221f]106If something does not work and it's not in the TODO section, then please contact me!
107
[f78f949]108== Known bugs
109
110- Sometimes when you get a lot of messages in a short time, some of the
111  messages are dropped. This is a known bug in Skype itself as of version
112  1.4.0.99
113  (http://forum.skype.com/index.php?s=&showtopic=94545&view=findpost&p=431710[link]).
114
[0c60f96]115== Screenshots
116
117You can reach some screenshots http://frugalware.org/~vmiklos/pics/shots/bitlbee-skype/[here].
[ddd3502]118
[a60c3c2]119== Changelog
120
121You can reach the Changelog link:Changelog[here].
122
[0c60f96]123// vim: ft=asciidoc
Note: See TracBrowser for help on using the repository browser.