source: skype/README @ 43e2e9d

Last change on this file since 43e2e9d was 8237df5, checked in by VMiklos <vmiklos@…>, at 2007-08-21T22:33:14Z

skyped: added daemon code

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