source: skype/README @ 56b56478

Last change on this file since 56b56478 was 56b56478, checked in by VMiklos <vmiklos@…>, at 2007-08-21T17:45:17Z

typo

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