source: skype/skype.c @ 8c09bb3

Last change on this file since 8c09bb3 was 8c09bb3, checked in by Miklos Vajna <vmiklos@…>, at 2009-01-07T00:58:15Z

whitespaces fixes

mainly long lines, except in skype_read_callback()
  • Property mode set to 100644
File size: 34.4 KB
Line 
1/*
2 *  skype.c - Skype plugin for BitlBee
3 *
4 *  Copyright (c) 2007, 2008, 2009 by Miklos Vajna <vmiklos@frugalware.org>
5 *
6 *  Several ideas are used from the BitlBee Jabber plugin, which is
7 *
8 *  Copyright (c) 2006 by Wilmer van der Gaast <wilmer@gaast.net>
9 *
10 *  This program is free software; you can redistribute it and/or modify
11 *  it under the terms of the GNU General Public License as published by
12 *  the Free Software Foundation; either version 2 of the License, or
13 *  (at your option) any later version.
14 *
15 *  This program is distributed in the hope that it will be useful,
16 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
17 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 *  GNU General Public License for more details.
19 *
20 *  You should have received a copy of the GNU General Public License
21 *  along with this program; if not, write to the Free Software
22 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
23 *  USA.
24 */
25
26#define _XOPEN_SOURCE
27#include <stdio.h>
28#include <poll.h>
29#include <bitlbee.h>
30#include <bitlbee/ssl_client.h>
31#include <glib.h>
32
33#define SKYPE_DEFAULT_SERVER "localhost"
34#define SKYPE_DEFAULT_PORT "2727"
35
36/*
37 * Enumerations
38 */
39
40typedef enum {
41        SKYPE_CALL_RINGING = 1,
42        SKYPE_CALL_MISSED,
43        SKYPE_CALL_CANCELLED,
44        SKYPE_CALL_FINISHED,
45        SKYPE_CALL_REFUSED
46} skype_call_status;
47
48typedef enum {
49        SKYPE_FILETRANSFER_NEW = 1,
50        SKYPE_FILETRANSFER_FAILED
51} skype_filetransfer_status;
52
53/*
54 * Structures
55 */
56
57struct skype_data {
58        struct im_connection *ic;
59        char *username;
60        /* The effective file descriptor. We store it here so any function can
61         * write() to it. */
62        int fd;
63        /* File descriptor returned by bitlbee. we store it so we know when
64         * we're connected and when we aren't. */
65        int bfd;
66        /* ssl_getfd() uses this to get the file desciptor. */
67        void *ssl;
68        /* When we receive a new message id, we query the properties, finally
69         * the chatname. Store the properties here so that we can use
70         * imcb_buddy_msg() when we got the chatname. */
71        char *handle;
72        /* List, because of multiline messages. */
73        GList *body;
74        char *type;
75        /* This is necessary because we send a notification when we get the
76         * handle. So we store the state here and then we can send a
77         * notification about the handle is in a given status. */
78        skype_call_status call_status;
79        char *call_id;
80        char *call_duration;
81        /* If the call is outgoing or not */
82        int call_out;
83        /* Same for file transfers. */
84        skype_filetransfer_status filetransfer_status;
85        /* Using /j #nick we want to have a groupchat with two people. Usually
86         * not (default). */
87        char *groupchat_with;
88        /* The user who invited us to the chat. */
89        char *adder;
90        /* If we are waiting for a confirmation about we changed the topic. */
91        int topic_wait;
92        /* These are used by the info command. */
93        char *info_fullname;
94        char *info_phonehome;
95        char *info_phoneoffice;
96        char *info_phonemobile;
97        char *info_nrbuddies;
98        char *info_tz;
99        char *info_seen;
100        char *info_birthday;
101        char *info_sex;
102        char *info_language;
103        char *info_country;
104        char *info_province;
105        char *info_city;
106        char *info_homepage;
107        char *info_about;
108        /* When a call fails, we get the reason and later we get the failure
109         * event, so store the failure code here till then */
110        int failurereason;
111};
112
113struct skype_away_state {
114        char *code;
115        char *full_name;
116};
117
118struct skype_buddy_ask_data {
119        struct im_connection *ic;
120        /* This is also used for call IDs for simplicity */
121        char *handle;
122};
123
124/*
125 * Tables
126 */
127
128const struct skype_away_state skype_away_state_list[] = {
129        { "ONLINE",  "Online" },
130        { "SKYPEME",  "Skype Me" },
131        { "AWAY",   "Away" },
132        { "NA",    "Not available" },
133        { "DND",      "Do Not Disturb" },
134        { "INVISIBLE",      "Invisible" },
135        { "OFFLINE",      "Offline" },
136        { NULL, NULL}
137};
138
139/*
140 * Functions
141 */
142
143int skype_write(struct im_connection *ic, char *buf)
144{
145        struct skype_data *sd = ic->proto_data;
146        struct pollfd pfd[1];
147        int len = strlen(buf);
148
149        pfd[0].fd = sd->fd;
150        pfd[0].events = POLLOUT;
151
152        /* This poll is necessary or we'll get a SIGPIPE when we write() to
153         * sd->fd. */
154        poll(pfd, 1, 1000);
155        if (pfd[0].revents & POLLHUP) {
156                imc_logout(ic, TRUE);
157                return FALSE;
158        }
159        ssl_write(sd->ssl, buf, len);
160
161        return TRUE;
162}
163
164static void skype_buddy_ask_yes(void *data)
165{
166        struct skype_buddy_ask_data *bla = data;
167        char *buf = g_strdup_printf("SET USER %s ISAUTHORIZED TRUE",
168                bla->handle);
169        skype_write(bla->ic, buf);
170        g_free(buf);
171        g_free(bla->handle);
172        g_free(bla);
173}
174
175static void skype_buddy_ask_no(void *data)
176{
177        struct skype_buddy_ask_data *bla = data;
178        char *buf = g_strdup_printf("SET USER %s ISAUTHORIZED FALSE",
179                bla->handle);
180        skype_write(bla->ic, buf);
181        g_free(buf);
182        g_free(bla->handle);
183        g_free(bla);
184}
185
186void skype_buddy_ask(struct im_connection *ic, char *handle, char *message)
187{
188        struct skype_buddy_ask_data *bla = g_new0(struct skype_buddy_ask_data,
189                1);
190        char *buf;
191
192        bla->ic = ic;
193        bla->handle = g_strdup(handle);
194
195        buf = g_strdup_printf("The user %s wants to add you to "
196                "his/her buddy list, saying: '%s'.", handle, message);
197        imcb_ask(ic, buf, bla, skype_buddy_ask_yes, skype_buddy_ask_no);
198        g_free(buf);
199}
200
201static void skype_call_ask_yes(void *data)
202{
203        struct skype_buddy_ask_data *bla = data;
204        char *buf = g_strdup_printf("SET CALL %s STATUS INPROGRESS",
205                bla->handle);
206        skype_write(bla->ic, buf);
207        g_free(buf);
208        g_free(bla->handle);
209        g_free(bla);
210}
211
212static void skype_call_ask_no(void *data)
213{
214        struct skype_buddy_ask_data *bla = data;
215        char *buf = g_strdup_printf("SET CALL %s STATUS FINISHED",
216                bla->handle);
217        skype_write(bla->ic, buf);
218        g_free(buf);
219        g_free(bla->handle);
220        g_free(bla);
221}
222
223void skype_call_ask(struct im_connection *ic, char *call_id, char *message)
224{
225        struct skype_buddy_ask_data *bla = g_new0(struct skype_buddy_ask_data,
226                1);
227
228        bla->ic = ic;
229        bla->handle = g_strdup(call_id);
230
231        imcb_ask(ic, message, bla, skype_call_ask_yes, skype_call_ask_no);
232}
233struct groupchat *skype_chat_by_name(struct im_connection *ic, char *name)
234{
235        struct groupchat *ret;
236
237        for (ret = ic->groupchats; ret; ret = ret->next)
238                if (strcmp(name, ret->title) == 0)
239                        break;
240
241        return ret;
242}
243
244static char *skype_call_strerror(int err)
245{
246        switch (err) {
247        case 1:
248                return "Miscellaneous error";
249        case 2:
250                return "User or phone number does not exist.";
251        case 3:
252                return "User is offline";
253        case 4:
254                return "No proxy found";
255        case 5:
256                return "Session terminated.";
257        case 6:
258                return "No common codec found.";
259        case 7:
260                return "Sound I/O error.";
261        case 8:
262                return "Problem with remote sound device.";
263        case 9:
264                return "Call blocked by recipient.";
265        case 10:
266                return "Recipient not a friend.";
267        case 11:
268                return "Current user not authorized by recipient.";
269        case 12:
270                return "Sound recording error.";
271        default:
272                return "Unknown error";
273        }
274}
275
276static gboolean skype_read_callback(gpointer data, gint fd,
277                                    b_input_condition cond)
278{
279        struct im_connection *ic = data;
280        struct skype_data *sd = ic->proto_data;
281        char buf[1024];
282        int st;
283        char **lines, **lineptr, *line, *ptr;
284
285        if (!sd || sd->fd == -1)
286                return FALSE;
287        /* Read the whole data. */
288        st = ssl_read(sd->ssl, buf, sizeof(buf));
289        if (st > 0) {
290                buf[st] = '\0';
291                /* Then split it up to lines. */
292                lines = g_strsplit(buf, "\n", 0);
293                lineptr = lines;
294                while ((line = *lineptr)) {
295                        if (!strlen(line))
296                                break;
297                        if (set_getbool(&ic->acc->set, "skypeconsole_receive"))
298                                imcb_buddy_msg(ic, "skypeconsole", line, 0, 0);
299                        if (!strncmp(line, "USERS ", 6)) {
300                                char **i;
301                                char **nicks;
302
303                                nicks = g_strsplit(line + 6, ", ", 0);
304                                i = nicks;
305                                while (*i) {
306                                        g_snprintf(buf, 1024, "GET USER %s ONLINESTATUS\n", *i);
307                                        skype_write(ic, buf);
308                                        i++;
309                                }
310                                g_strfreev(nicks);
311                        } else if (!strncmp(line, "USER ", 5)) {
312                                int flags = 0;
313                                char *status = strrchr(line, ' ');
314                                char *user = strchr(line, ' ');
315                                status++;
316                                ptr = strchr(++user, ' ');
317                                *ptr = '\0';
318                                ptr++;
319                                if (!strncmp(ptr, "ONLINESTATUS ", 13) &&
320                                                strcmp(user, sd->username) != 0
321                                                && strcmp(user, "echo123") != 0) {
322                                        ptr = g_strdup_printf("%s@skype.com", user);
323                                        imcb_add_buddy(ic, ptr, NULL);
324                                        if (strcmp(status, "OFFLINE") && (strcmp(status, "SKYPEOUT") || !set_getbool(&ic->acc->set, "skypeout_offline")))
325                                                flags |= OPT_LOGGED_IN;
326                                        if (strcmp(status, "ONLINE") != 0 && strcmp(status, "SKYPEME") != 0)
327                                                flags |= OPT_AWAY;
328                                        imcb_buddy_status(ic, ptr, flags, NULL, NULL);
329                                        g_free(ptr);
330                                } else if (!strncmp(ptr, "RECEIVEDAUTHREQUEST ", 20)) {
331                                        char *message = ptr + 20;
332                                        if (strlen(message))
333                                                skype_buddy_ask(ic, user, message);
334                                } else if (!strncmp(ptr, "BUDDYSTATUS ", 12)) {
335                                        char *st = ptr + 12;
336                                        if (!strcmp(st, "3")) {
337                                                char *buf = g_strdup_printf("%s@skype.com", user);
338                                                imcb_add_buddy(ic, buf, NULL);
339                                                g_free(buf);
340                                        }
341                                } else if (!strncmp(ptr, "FULLNAME ", 9))
342                                        sd->info_fullname = g_strdup_printf("%s", ptr + 9);
343                                else if (!strncmp(ptr, "PHONE_HOME ", 11))
344                                        sd->info_phonehome = g_strdup_printf("%s", ptr + 11);
345                                else if (!strncmp(ptr, "PHONE_OFFICE ", 13))
346                                        sd->info_phoneoffice = g_strdup_printf("%s", ptr + 13);
347                                else if (!strncmp(ptr, "PHONE_MOBILE ", 13))
348                                        sd->info_phonemobile = g_strdup_printf("%s", ptr + 13);
349                                else if (!strncmp(ptr, "NROF_AUTHED_BUDDIES ", 20))
350                                        sd->info_nrbuddies = g_strdup_printf("%s", ptr + 20);
351                                else if (!strncmp(ptr, "TIMEZONE ", 9))
352                                        sd->info_tz = g_strdup_printf("%s", ptr + 9);
353                                else if (!strncmp(ptr, "LASTONLINETIMESTAMP ", 20))
354                                        sd->info_seen = g_strdup_printf("%s", ptr + 20);
355                                else if (!strncmp(ptr, "BIRTHDAY ", 9))
356                                        sd->info_birthday = g_strdup_printf("%s", ptr + 9);
357                                else if (!strncmp(ptr, "SEX ", 4))
358                                        sd->info_sex = g_strdup_printf("%s", ptr + 4);
359                                else if (!strncmp(ptr, "LANGUAGE ", 9))
360                                        sd->info_language = g_strdup_printf("%s", ptr + 9);
361                                else if (!strncmp(ptr, "COUNTRY ", 8))
362                                        sd->info_country = g_strdup_printf("%s", ptr + 8);
363                                else if (!strncmp(ptr, "PROVINCE ", 9))
364                                        sd->info_province = g_strdup_printf("%s", ptr + 9);
365                                else if (!strncmp(ptr, "CITY ", 5))
366                                        sd->info_city = g_strdup_printf("%s", ptr + 5);
367                                else if (!strncmp(ptr, "HOMEPAGE ", 9))
368                                        sd->info_homepage = g_strdup_printf("%s", ptr + 9);
369                                else if (!strncmp(ptr, "ABOUT ", 6)) {
370                                        sd->info_about = g_strdup_printf("%s", ptr + 6);
371
372                                        GString *st = g_string_new("Contact Information\n");
373                                        g_string_append_printf(st, "Skype Name: %s\n", user);
374                                        if (sd->info_fullname) {
375                                                if (strlen(sd->info_fullname))
376                                                        g_string_append_printf(st, "Full Name: %s\n", sd->info_fullname);
377                                                g_free(sd->info_fullname);
378                                        }
379                                        if (sd->info_phonehome) {
380                                                if (strlen(sd->info_phonehome))
381                                                        g_string_append_printf(st, "Home Phone: %s\n", sd->info_phonehome);
382                                                g_free(sd->info_phonehome);
383                                        }
384                                        if (sd->info_phoneoffice) {
385                                                if (strlen(sd->info_phoneoffice))
386                                                        g_string_append_printf(st, "Office Phone: %s\n", sd->info_phoneoffice);
387                                                g_free(sd->info_phoneoffice);
388                                        }
389                                        if (sd->info_phonemobile) {
390                                                if (strlen(sd->info_phonemobile))
391                                                        g_string_append_printf(st, "Mobile Phone: %s\n", sd->info_phonemobile);
392                                                g_free(sd->info_phonemobile);
393                                        }
394                                        g_string_append_printf(st, "Personal Information\n");
395                                        if (sd->info_nrbuddies) {
396                                                if (strlen(sd->info_nrbuddies))
397                                                        g_string_append_printf(st, "Contacts: %s\n", sd->info_nrbuddies);
398                                                g_free(sd->info_nrbuddies);
399                                        }
400                                        if (sd->info_tz) {
401                                                if (strlen(sd->info_tz)) {
402                                                        char ib[256];
403                                                        time_t t = time(NULL);
404                                                        t += atoi(sd->info_tz)-(60*60*24);
405                                                        struct tm *gt = gmtime(&t);
406                                                        strftime(ib, 256, "%H:%M:%S", gt);
407                                                        g_string_append_printf(st, "Local Time: %s\n", ib);
408                                                }
409                                                g_free(sd->info_tz);
410                                        }
411                                        if (sd->info_seen) {
412                                                if (strlen(sd->info_seen)) {
413                                                        char ib[256];
414                                                        time_t it = atoi(sd->info_seen);
415                                                        struct tm *tm = localtime(&it);
416                                                        strftime(ib, 256, ("%Y. %m. %d. %H:%M"), tm);
417                                                        g_string_append_printf(st, "Last Seen: %s\n", ib);
418                                                }
419                                                g_free(sd->info_seen);
420                                        }
421                                        if (sd->info_birthday) {
422                                                if (strlen(sd->info_birthday) && strcmp(sd->info_birthday, "0")) {
423                                                        char ib[256];
424                                                        struct tm tm;
425                                                        strptime(sd->info_birthday, "%Y%m%d", &tm);
426                                                        strftime(ib, 256, "%B %d, %Y", &tm);
427                                                        g_string_append_printf(st, "Birthday: %s\n", ib);
428
429                                                        strftime(ib, 256, "%Y", &tm);
430                                                        int year = atoi(ib);
431                                                        time_t t = time(NULL);
432                                                        struct tm *lt = localtime(&t);
433                                                        g_string_append_printf(st, "Age: %d\n", lt->tm_year+1900-year);
434                                                }
435                                                g_free(sd->info_birthday);
436                                        }
437                                        if (sd->info_sex) {
438                                                if (strlen(sd->info_sex)) {
439                                                        char *iptr = sd->info_sex;
440                                                        while (*iptr++)
441                                                                *iptr = tolower(*iptr);
442                                                        g_string_append_printf(st, "Gender: %s\n", sd->info_sex);
443                                                }
444                                                g_free(sd->info_sex);
445                                        }
446                                        if (sd->info_language) {
447                                                if (strlen(sd->info_language)) {
448                                                        char *iptr = strchr(sd->info_language, ' ');
449                                                        if (iptr)
450                                                                iptr++;
451                                                        else
452                                                                iptr = sd->info_language;
453                                                        g_string_append_printf(st, "Language: %s\n", iptr);
454                                                }
455                                                g_free(sd->info_language);
456                                        }
457                                        if (sd->info_country) {
458                                                if (strlen(sd->info_country)) {
459                                                        char *iptr = strchr(sd->info_country, ' ');
460                                                        if (iptr)
461                                                                iptr++;
462                                                        else
463                                                                iptr = sd->info_country;
464                                                        g_string_append_printf(st, "Country: %s\n", iptr);
465                                                }
466                                                g_free(sd->info_country);
467                                        }
468                                        if (sd->info_province) {
469                                                if (strlen(sd->info_province))
470                                                        g_string_append_printf(st, "Region: %s\n", sd->info_province);
471                                                g_free(sd->info_province);
472                                        }
473                                        if (sd->info_city) {
474                                                if (strlen(sd->info_city))
475                                                        g_string_append_printf(st, "City: %s\n", sd->info_city);
476                                                g_free(sd->info_city);
477                                        }
478                                        if (sd->info_homepage) {
479                                                if (strlen(sd->info_homepage))
480                                                        g_string_append_printf(st, "Homepage: %s\n", sd->info_homepage);
481                                                g_free(sd->info_homepage);
482                                        }
483                                        if (sd->info_about) {
484                                                if (strlen(sd->info_about))
485                                                        g_string_append_printf(st, "%s\n", sd->info_about);
486                                                g_free(sd->info_about);
487                                        }
488                                        imcb_log(ic, "%s", st->str);
489                                        g_string_free(st, TRUE);
490                                }
491                        } else if (!strncmp(line, "CHATMESSAGE ", 12)) {
492                                char *id = strchr(line, ' ');
493                                if (++id) {
494                                        char *info = strchr(id, ' ');
495                                        *info = '\0';
496                                        info++;
497                                        if (!strcmp(info, "STATUS RECEIVED")) {
498                                                /* New message ID:
499                                                 * (1) Request its from field
500                                                 * (2) Request its body
501                                                 * (3) Request its type
502                                                 * (4) Query chatname
503                                                 */
504                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s FROM_HANDLE\n", id);
505                                                skype_write(ic, buf);
506                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s BODY\n", id);
507                                                skype_write(ic, buf);
508                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s TYPE\n", id);
509                                                skype_write(ic, buf);
510                                                g_snprintf(buf, 1024, "GET CHATMESSAGE %s CHATNAME\n", id);
511                                                skype_write(ic, buf);
512                                        } else if (!strncmp(info, "FROM_HANDLE ", 12)) {
513                                                info += 12;
514                                                /* New from field value. Store
515                                                 * it, then we can later use it
516                                                 * when we got the message's
517                                                 * body. */
518                                                g_free(sd->handle);
519                                                sd->handle = g_strdup_printf("%s@skype.com", info);
520                                        } else if (!strncmp(info, "EDITED_BY ", 10)) {
521                                                info += 10;
522                                                /* This is the same as
523                                                 * FROM_HANDLE, except that we
524                                                 * never request these lines
525                                                 * from Skype, we just get
526                                                 * them. */
527                                                g_free(sd->handle);
528                                                sd->handle = g_strdup_printf("%s@skype.com", info);
529                                        } else if (!strncmp(info, "BODY ", 5)) {
530                                                info += 5;
531                                                sd->body = g_list_append(sd->body, g_strdup(info));
532                                        }       else if (!strncmp(info, "TYPE ", 5)) {
533                                                info += 5;
534                                                g_free(sd->type);
535                                                sd->type = g_strdup(info);
536                                        } else if (!strncmp(info, "CHATNAME ", 9)) {
537                                                info += 9;
538                                                if (sd->handle && sd->body && sd->type) {
539                                                        struct groupchat *gc = skype_chat_by_name(ic, info);
540                                                        int i;
541                                                        for (i = 0; i < g_list_length(sd->body); i++) {
542                                                                char *body = g_list_nth_data(sd->body, i);
543                                                                if (!strcmp(sd->type, "SAID") || !strcmp(sd->type, "EMOTED")) {
544                                                                        char *st;
545                                                                        if (!strcmp(sd->type, "SAID"))
546                                                                                st = g_strdup(body);
547                                                                        else
548                                                                                st = g_strdup_printf("/me %s", body);
549                                                                        if (!gc)
550                                                                                /* Private message */
551                                                                                imcb_buddy_msg(ic, sd->handle, st, 0, 0);
552                                                                        else
553                                                                                /* Groupchat message */
554                                                                                imcb_chat_msg(gc, sd->handle, st, 0, 0);
555                                                                        g_free(st);
556                                                                } else if (!strcmp(sd->type, "SETTOPIC")) {
557                                                                        if (gc)
558                                                                                imcb_chat_topic(gc, sd->handle, body, 0);
559                                                                } else if (!strcmp(sd->type, "LEFT")) {
560                                                                        if (gc)
561                                                                                imcb_chat_remove_buddy(gc, sd->handle, NULL);
562                                                                }
563                                                        }
564                                                        g_list_free(sd->body);
565                                                        sd->body = NULL;
566                                                }
567                                        }
568                                }
569                        } else if (!strncmp(line, "CALL ", 5)) {
570                                char *id = strchr(line, ' ');
571                                if (++id) {
572                                        char *info = strchr(id, ' ');
573                                        *info = '\0';
574                                        info++;
575                                        if (!strncmp(info, "FAILUREREASON ", 14))
576                                                sd->failurereason = atoi(strchr(info, ' '));
577                                        else if (!strcmp(info, "STATUS RINGING")) {
578                                                if (sd->call_id)
579                                                        g_free(sd->call_id);
580                                                sd->call_id = g_strdup(id);
581                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
582                                                skype_write(ic, buf);
583                                                sd->call_status = SKYPE_CALL_RINGING;
584                                        } else if (!strcmp(info, "STATUS MISSED")) {
585                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
586                                                skype_write(ic, buf);
587                                                sd->call_status = SKYPE_CALL_MISSED;
588                                        } else if (!strcmp(info, "STATUS CANCELLED")) {
589                                                        g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
590                                                        skype_write(ic, buf);
591                                                        sd->call_status = SKYPE_CALL_CANCELLED;
592                                        } else if (!strcmp(info, "STATUS FINISHED")) {
593                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
594                                                skype_write(ic, buf);
595                                                sd->call_status = SKYPE_CALL_FINISHED;
596                                        } else if (!strcmp(info, "STATUS REFUSED")) {
597                                                g_snprintf(buf, 1024, "GET CALL %s PARTNER_HANDLE\n", id);
598                                                skype_write(ic, buf);
599                                                sd->call_status = SKYPE_CALL_REFUSED;
600                                        } else if (!strcmp(info, "STATUS UNPLACED")) {
601                                                if (sd->call_id)
602                                                        g_free(sd->call_id);
603                                                /* Save the ID for later usage (Cancel/Finish). */
604                                                sd->call_id = g_strdup(id);
605                                                sd->call_out = TRUE;
606                                        } else if (!strcmp(info, "STATUS FAILED")) {
607                                                imcb_error(ic, "Call failed: %s", skype_call_strerror(sd->failurereason));
608                                                sd->call_id = NULL;
609                                        } else if (!strncmp(info, "DURATION ", 9)) {
610                                                if (sd->call_duration)
611                                                        g_free(sd->call_duration);
612                                                sd->call_duration = g_strdup(info+9);
613                                        } else if (!strncmp(info, "PARTNER_HANDLE ", 15)) {
614                                                info += 15;
615                                                if (sd->call_status) {
616                                                        switch (sd->call_status) {
617                                                        case SKYPE_CALL_RINGING:
618                                                                if (sd->call_out)
619                                                                        imcb_log(ic, "You are currently ringing the user %s.", info);
620                                                                else {
621                                                                        g_snprintf(buf, 1024, "The user %s is currently ringing you.", info);
622                                                                        skype_call_ask(ic, sd->call_id, buf);
623                                                                }
624                                                                break;
625                                                        case SKYPE_CALL_MISSED:
626                                                                imcb_log(ic, "You have missed a call from user %s.", info);
627                                                                break;
628                                                        case SKYPE_CALL_CANCELLED:
629                                                                imcb_log(ic, "You cancelled the call to the user %s.", info);
630                                                                sd->call_status = 0;
631                                                                sd->call_out = FALSE;
632                                                                break;
633                                                        case SKYPE_CALL_REFUSED:
634                                                                if (sd->call_out)
635                                                                        imcb_log(ic, "The user %s refused the call.", info);
636                                                                else
637                                                                        imcb_log(ic, "You refused the call from user %s.", info);
638                                                                sd->call_out = FALSE;
639                                                                break;
640                                                        case SKYPE_CALL_FINISHED:
641                                                                if (sd->call_duration)
642                                                                        imcb_log(ic, "You finished the call to the user %s (duration: %s seconds).", info, sd->call_duration);
643                                                                else
644                                                                        imcb_log(ic, "You finished the call to the user %s.", info);
645                                                                sd->call_out = FALSE;
646                                                                break;
647                                                        default:
648                                                                /* Don't be noisy, ignore other statuses for now. */
649                                                                break;
650                                                        }
651                                                        sd->call_status = 0;
652                                                }
653                                        }
654                                }
655                        } else if (!strncmp(line, "FILETRANSFER ", 13)) {
656                                char *id = strchr(line, ' ');
657                                if (++id) {
658                                        char *info = strchr(id, ' ');
659                                        *info = '\0';
660                                        info++;
661                                        if (!strcmp(info, "STATUS NEW")) {
662                                                g_snprintf(buf, 1024, "GET FILETRANSFER %s PARTNER_HANDLE\n", id);
663                                                skype_write(ic, buf);
664                                                sd->filetransfer_status = SKYPE_FILETRANSFER_NEW;
665                                        } else if (!strcmp(info, "STATUS FAILED")) {
666                                                g_snprintf(buf, 1024, "GET FILETRANSFER %s PARTNER_HANDLE\n", id);
667                                                skype_write(ic, buf);
668                                                sd->filetransfer_status = SKYPE_FILETRANSFER_FAILED;
669                                        } else if (!strncmp(info, "PARTNER_HANDLE ", 15)) {
670                                                info += 15;
671                                                if (sd->filetransfer_status) {
672                                                        switch (sd->filetransfer_status) {
673                                                        case SKYPE_FILETRANSFER_NEW:
674                                                                imcb_log(ic, "The user %s offered a new file for you.", info);
675                                                                break;
676                                                        case SKYPE_FILETRANSFER_FAILED:
677                                                                imcb_log(ic, "Failed to transfer file from user %s.", info);
678                                                                break;
679                                                        }
680                                                        sd->filetransfer_status = 0;
681                                                }
682                                        }
683                                }
684                        } else if (!strncmp(line, "CHAT ", 5)) {
685                                char *id = strchr(line, ' ');
686                                if (++id) {
687                                        char *info = strchr(id, ' ');
688                                        if (info)
689                                                *info = '\0';
690                                        info++;
691                                        /* Remove fake chat if we created one in skype_chat_with() */
692                                        struct groupchat *gc = skype_chat_by_name(ic, "");
693                                        if (gc)
694                                                imcb_chat_free(gc);
695                                        if (!strcmp(info, "STATUS MULTI_SUBSCRIBED")) {
696                                                imcb_chat_new(ic, id);
697                                                g_snprintf(buf, 1024, "GET CHAT %s ADDER\n", id);
698                                                skype_write(ic, buf);
699                                                g_snprintf(buf, 1024, "GET CHAT %s TOPIC\n", id);
700                                                skype_write(ic, buf);
701                                        } else if (!strcmp(info, "STATUS DIALOG") && sd->groupchat_with) {
702                                                gc = imcb_chat_new(ic, id);
703                                                /* According to the docs this
704                                                 * is necessary. However it
705                                                 * does not seem the situation
706                                                 * and it would open an extra
707                                                 * window on our client, so
708                                                 * just leave it out. */
709                                                /*g_snprintf(buf, 1024, "OPEN CHAT %s\n", id);
710                                                skype_write(ic, buf);*/
711                                                g_snprintf(buf, 1024, "%s@skype.com", sd->groupchat_with);
712                                                imcb_chat_add_buddy(gc, buf);
713                                                imcb_chat_add_buddy(gc, sd->username);
714                                                g_free(sd->groupchat_with);
715                                                sd->groupchat_with = NULL;
716                                                g_snprintf(buf, 1024, "GET CHAT %s ADDER\n", id);
717                                                skype_write(ic, buf);
718                                                g_snprintf(buf, 1024, "GET CHAT %s TOPIC\n", id);
719                                                skype_write(ic, buf);
720                                        } else if (!strcmp(info, "STATUS UNSUBSCRIBED")) {
721                                                gc = skype_chat_by_name(ic, id);
722                                                if (gc)
723                                                        gc->data = (void *)FALSE;
724                                        } else if (!strncmp(info, "ADDER ", 6)) {
725                                                info += 6;
726                                                g_free(sd->adder);
727                                                sd->adder = g_strdup_printf("%s@skype.com", info);
728                                        } else if (!strncmp(info, "TOPIC ", 6)) {
729                                                info += 6;
730                                                gc = skype_chat_by_name(ic, id);
731                                                if (gc && (sd->adder || sd->topic_wait)) {
732                                                        if (sd->topic_wait) {
733                                                                sd->adder = g_strdup(sd->username);
734                                                                sd->topic_wait = 0;
735                                                        }
736                                                        imcb_chat_topic(gc, sd->adder, info, 0);
737                                                        g_free(sd->adder);
738                                                        sd->adder = NULL;
739                                                }
740                                        } else if (!strncmp(info, "ACTIVEMEMBERS ", 14)) {
741                                                info += 14;
742                                                gc = skype_chat_by_name(ic, id);
743                                                /* Hack! We set ->data to TRUE
744                                                 * while we're on the channel
745                                                 * so that we won't rejoin
746                                                 * after a /part. */
747                                                if (gc && !gc->data) {
748                                                        char **members = g_strsplit(info, " ", 0);
749                                                        int i;
750                                                        for (i = 0; members[i]; i++) {
751                                                                if (!strcmp(members[i], sd->username))
752                                                                        continue;
753                                                                g_snprintf(buf, 1024, "%s@skype.com", members[i]);
754                                                                if (!g_list_find_custom(gc->in_room, buf, (GCompareFunc)strcmp))
755                                                                        imcb_chat_add_buddy(gc, buf);
756                                                        }
757                                                        imcb_chat_add_buddy(gc, sd->username);
758                                                        g_strfreev(members);
759                                                }
760                                        }
761                                }
762                        } else if (!strncmp(line, "PASSWORD ", 9)) {
763                                if (!strncmp(line+9, "OK", 2))
764                                        imcb_connected(ic);
765                                else {
766                                        imcb_error(ic, "Authentication Failed");
767                                        imc_logout(ic, TRUE);
768                                }
769                        } else if (!strncmp(line, "PROFILE PSTN_BALANCE ", 21))
770                                imcb_log(ic, "SkypeOut balance value is '%s'.", line+21);
771                        else if (!strncmp(line, "PING", 4)) {
772                                g_snprintf(buf, 1024, "PONG\n");
773                                skype_write(ic, buf);
774                        } else if (!strncmp(line, "CHATS ", 6)) {
775                                char **i;
776                                char **chats = g_strsplit(line + 6, ", ", 0);
777
778                                i = chats;
779                                while (*i) {
780                                        g_snprintf(buf, 1024, "GET CHAT %s STATUS\n", *i);
781                                        skype_write(ic, buf);
782                                        g_snprintf(buf, 1024, "GET CHAT %s ACTIVEMEMBERS\n", *i);
783                                        skype_write(ic, buf);
784                                        i++;
785                                }
786                                g_strfreev(chats);
787                        }
788                        lineptr++;
789                }
790                g_strfreev(lines);
791        } else if (st == 0 || (st < 0 && !sockerr_again())) {
792                closesocket(sd->fd);
793                sd->fd = -1;
794
795                imcb_error(ic, "Error while reading from server");
796                imc_logout(ic, TRUE);
797                return FALSE;
798        }
799        return TRUE;
800}
801
802gboolean skype_start_stream(struct im_connection *ic)
803{
804        struct skype_data *sd = ic->proto_data;
805        char *buf;
806        int st;
807
808        if (!sd)
809                return FALSE;
810
811        if (sd->bfd <= 0)
812                sd->bfd = b_input_add(sd->fd, GAIM_INPUT_READ,
813                        skype_read_callback, ic);
814
815        /* Log in */
816        buf = g_strdup_printf("USERNAME %s\n", ic->acc->user);
817        st = skype_write(ic, buf);
818        g_free(buf);
819        buf = g_strdup_printf("PASSWORD %s\n", ic->acc->pass);
820        st = skype_write(ic, buf);
821        g_free(buf);
822
823        /* This will download all buddies. */
824        buf = g_strdup_printf("SEARCH FRIENDS\n");
825        st = skype_write(ic, buf);
826        g_free(buf);
827        buf = g_strdup_printf("SET USERSTATUS ONLINE\n");
828        skype_write(ic, buf);
829        g_free(buf);
830
831        /* Auto join to bookmarked chats if requested.*/
832        if (set_getbool(&ic->acc->set, "auto_join")) {
833                buf = g_strdup_printf("SEARCH BOOKMARKEDCHATS\n");
834                skype_write(ic, buf);
835                g_free(buf);
836        }
837        return st;
838}
839
840gboolean skype_connected(gpointer data, void *source, b_input_condition cond)
841{
842        struct im_connection *ic = data;
843        struct skype_data *sd = ic->proto_data;
844        if (!source) {
845                sd->ssl = NULL;
846                imcb_error(ic, "Could not connect to server");
847                imc_logout(ic, TRUE);
848                return FALSE;
849        }
850        imcb_log(ic, "Connected to server, logging in");
851        return skype_start_stream(ic);
852}
853
854static void skype_login(account_t *acc)
855{
856        struct im_connection *ic = imcb_new(acc);
857        struct skype_data *sd = g_new0(struct skype_data, 1);
858
859        ic->proto_data = sd;
860
861        imcb_log(ic, "Connecting");
862        sd->ssl = ssl_connect(set_getstr(&acc->set, "server"),
863                set_getint(&acc->set, "port"), skype_connected, ic);
864        sd->fd = sd->ssl ? ssl_getfd(sd->ssl) : -1;
865        sd->username = g_strdup(acc->user);
866
867        sd->ic = ic;
868
869        if (set_getbool(&acc->set, "skypeconsole"))
870                imcb_add_buddy(ic, "skypeconsole", NULL);
871}
872
873static void skype_logout(struct im_connection *ic)
874{
875        struct skype_data *sd = ic->proto_data;
876        char *buf;
877
878        buf = g_strdup_printf("SET USERSTATUS OFFLINE\n");
879        skype_write(ic, buf);
880        g_free(buf);
881
882        g_free(sd->username);
883        g_free(sd->handle);
884        g_free(sd);
885        ic->proto_data = NULL;
886}
887
888static int skype_buddy_msg(struct im_connection *ic, char *who, char *message,
889                           int flags)
890{
891        char *buf, *ptr, *nick;
892        int st;
893
894        nick = g_strdup(who);
895        ptr = strchr(nick, '@');
896        if (ptr)
897                *ptr = '\0';
898
899        if (!strncmp(who, "skypeconsole", 12))
900                buf = g_strdup_printf("%s\n", message);
901        else
902                buf = g_strdup_printf("MESSAGE %s %s\n", nick, message);
903        g_free(nick);
904        st = skype_write(ic, buf);
905        g_free(buf);
906
907        return st;
908}
909
910const struct skype_away_state *skype_away_state_by_name(char *name)
911{
912        int i;
913
914        for (i = 0; skype_away_state_list[i].full_name; i++)
915                if (g_strcasecmp(skype_away_state_list[i].full_name, name) == 0)
916                        return skype_away_state_list + i;
917
918        return NULL;
919}
920
921static void skype_set_away(struct im_connection *ic, char *state_txt,
922                           char *message)
923{
924        const struct skype_away_state *state;
925        char *buf;
926
927        if (strcmp(state_txt, GAIM_AWAY_CUSTOM) == 0)
928                state = skype_away_state_by_name("Away");
929        else
930                state = skype_away_state_by_name(state_txt);
931        buf = g_strdup_printf("SET USERSTATUS %s\n", state->code);
932        skype_write(ic, buf);
933        g_free(buf);
934}
935
936static GList *skype_away_states(struct im_connection *ic)
937{
938        static GList *l;
939        int i;
940
941        if (l == NULL)
942                for (i = 0; skype_away_state_list[i].full_name; i++)
943                        l = g_list_append(l,
944                                (void *)skype_away_state_list[i].full_name);
945
946        return l;
947}
948
949static char *skype_set_display_name(set_t *set, char *value)
950{
951        account_t *acc = set->data;
952        struct im_connection *ic = acc->ic;
953        char *buf;
954
955        buf = g_strdup_printf("SET PROFILE FULLNAME %s", value);
956        skype_write(ic, buf);
957        g_free(buf);
958        return value;
959}
960
961static char *skype_set_balance(set_t *set, char *value)
962{
963        account_t *acc = set->data;
964        struct im_connection *ic = acc->ic;
965        char *buf;
966
967        buf = g_strdup_printf("GET PROFILE PSTN_BALANCE");
968        skype_write(ic, buf);
969        g_free(buf);
970        return value;
971}
972
973static char *skype_set_call(set_t *set, char *value)
974{
975        account_t *acc = set->data;
976        struct im_connection *ic = acc->ic;
977        struct skype_data *sd = ic->proto_data;
978        char *nick, *ptr, *buf;
979
980        if (value) {
981                user_t *u = user_find(acc->irc, value);
982                /* We are starting a call */
983                if (!u)
984                        nick = g_strdup(value);
985                else
986                        nick = g_strdup(u->handle);
987                ptr = strchr(nick, '@');
988                if (ptr)
989                        *ptr = '\0';
990
991                buf = g_strdup_printf("CALL %s", nick);
992                skype_write(ic, buf);
993                g_free(buf);
994                g_free(nick);
995        } else {
996                /* We are ending a call */
997                if (sd->call_id) {
998                        buf = g_strdup_printf("SET CALL %s STATUS FINISHED",
999                                sd->call_id);
1000                        skype_write(ic, buf);
1001                        g_free(buf);
1002                        g_free(sd->call_id);
1003                        sd->call_id = NULL;
1004                } else
1005                        imcb_error(ic, "There are no active calls currently.");
1006        }
1007        return value;
1008}
1009
1010static void skype_add_buddy(struct im_connection *ic, char *who, char *group)
1011{
1012        char *buf, *nick, *ptr;
1013
1014        nick = g_strdup(who);
1015        ptr = strchr(nick, '@');
1016        if (ptr)
1017                *ptr = '\0';
1018        buf = g_strdup_printf("SET USER %s BUDDYSTATUS 2 Please authorize me\n",
1019                nick);
1020        skype_write(ic, buf);
1021        g_free(nick);
1022}
1023
1024static void skype_remove_buddy(struct im_connection *ic, char *who, char *group)
1025{
1026        char *buf, *nick, *ptr;
1027
1028        nick = g_strdup(who);
1029        ptr = strchr(nick, '@');
1030        if (ptr)
1031                *ptr = '\0';
1032        buf = g_strdup_printf("SET USER %s BUDDYSTATUS 1\n", nick);
1033        skype_write(ic, buf);
1034        g_free(nick);
1035}
1036
1037void skype_chat_msg(struct groupchat *gc, char *message, int flags)
1038{
1039        struct im_connection *ic = gc->ic;
1040        char *buf;
1041        buf = g_strdup_printf("CHATMESSAGE %s %s\n", gc->title, message);
1042        skype_write(ic, buf);
1043        g_free(buf);
1044}
1045
1046void skype_chat_leave(struct groupchat *gc)
1047{
1048        struct im_connection *ic = gc->ic;
1049        char *buf;
1050        buf = g_strdup_printf("ALTER CHAT %s LEAVE\n", gc->title);
1051        skype_write(ic, buf);
1052        g_free(buf);
1053        gc->data = (void *)TRUE;
1054}
1055
1056void skype_chat_invite(struct groupchat *gc, char *who, char *message)
1057{
1058        struct im_connection *ic = gc->ic;
1059        char *buf, *ptr, *nick;
1060        nick = g_strdup(message);
1061        ptr = strchr(nick, '@');
1062        if (ptr)
1063                *ptr = '\0';
1064        buf = g_strdup_printf("ALTER CHAT %s ADDMEMBERS %s\n", gc->title, nick);
1065        skype_write(ic, buf);
1066        g_free(buf);
1067        g_free(nick);
1068}
1069
1070void skype_chat_topic(struct groupchat *gc, char *message)
1071{
1072        struct im_connection *ic = gc->ic;
1073        struct skype_data *sd = ic->proto_data;
1074        char *buf;
1075        buf = g_strdup_printf("ALTER CHAT %s SETTOPIC %s\n",
1076                gc->title, message);
1077        skype_write(ic, buf);
1078        g_free(buf);
1079        sd->topic_wait = 1;
1080}
1081
1082struct groupchat *skype_chat_with(struct im_connection *ic, char *who)
1083{
1084        struct skype_data *sd = ic->proto_data;
1085        char *ptr, *nick, *buf;
1086        nick = g_strdup(who);
1087        ptr = strchr(nick, '@');
1088        if (ptr)
1089                *ptr = '\0';
1090        buf = g_strdup_printf("CHAT CREATE %s\n", nick);
1091        skype_write(ic, buf);
1092        g_free(buf);
1093        sd->groupchat_with = g_strdup(nick);
1094        g_free(nick);
1095        /* We create a fake chat for now. We will replace it with a real one in
1096         * the real callback. */
1097        return imcb_chat_new(ic, "");
1098}
1099
1100static void skype_get_info(struct im_connection *ic, char *who)
1101{
1102        char *ptr, *nick, *buf;
1103        nick = g_strdup(who);
1104        ptr = strchr(nick, '@');
1105        if (ptr)
1106                *ptr = '\0';
1107        buf = g_strdup_printf("GET USER %s FULLNAME\n", nick);
1108        skype_write(ic, buf);
1109        g_free(buf);
1110        buf = g_strdup_printf("GET USER %s PHONE_HOME\n", nick);
1111        skype_write(ic, buf);
1112        g_free(buf);
1113        buf = g_strdup_printf("GET USER %s PHONE_OFFICE\n", nick);
1114        skype_write(ic, buf);
1115        g_free(buf);
1116        buf = g_strdup_printf("GET USER %s PHONE_MOBILE\n", nick);
1117        skype_write(ic, buf);
1118        g_free(buf);
1119        buf = g_strdup_printf("GET USER %s NROF_AUTHED_BUDDIES\n", nick);
1120        skype_write(ic, buf);
1121        g_free(buf);
1122        buf = g_strdup_printf("GET USER %s TIMEZONE\n", nick);
1123        skype_write(ic, buf);
1124        g_free(buf);
1125        buf = g_strdup_printf("GET USER %s LASTONLINETIMESTAMP\n", nick);
1126        skype_write(ic, buf);
1127        g_free(buf);
1128        buf = g_strdup_printf("GET USER %s BIRTHDAY\n", nick);
1129        skype_write(ic, buf);
1130        g_free(buf);
1131        buf = g_strdup_printf("GET USER %s SEX\n", nick);
1132        skype_write(ic, buf);
1133        g_free(buf);
1134        buf = g_strdup_printf("GET USER %s LANGUAGE\n", nick);
1135        skype_write(ic, buf);
1136        g_free(buf);
1137        buf = g_strdup_printf("GET USER %s COUNTRY\n", nick);
1138        skype_write(ic, buf);
1139        g_free(buf);
1140        buf = g_strdup_printf("GET USER %s PROVINCE\n", nick);
1141        skype_write(ic, buf);
1142        g_free(buf);
1143        buf = g_strdup_printf("GET USER %s CITY\n", nick);
1144        skype_write(ic, buf);
1145        g_free(buf);
1146        buf = g_strdup_printf("GET USER %s HOMEPAGE\n", nick);
1147        skype_write(ic, buf);
1148        g_free(buf);
1149        buf = g_strdup_printf("GET USER %s ABOUT\n", nick);
1150        skype_write(ic, buf);
1151        g_free(buf);
1152}
1153
1154static void skype_set_my_name(struct im_connection *ic, char *info)
1155{
1156        skype_set_display_name(set_find(&ic->acc->set, "display_name"), info);
1157}
1158
1159static void skype_init(account_t *acc)
1160{
1161        set_t *s;
1162
1163        s = set_add(&acc->set, "server", SKYPE_DEFAULT_SERVER, set_eval_account,
1164                acc);
1165        s->flags |= ACC_SET_OFFLINE_ONLY;
1166
1167        s = set_add(&acc->set, "port", SKYPE_DEFAULT_PORT, set_eval_int, acc);
1168        s->flags |= ACC_SET_OFFLINE_ONLY;
1169
1170        s = set_add(&acc->set, "display_name", NULL, skype_set_display_name,
1171                acc);
1172        s->flags |= ACC_SET_NOSAVE | ACC_SET_ONLINE_ONLY;
1173
1174        s = set_add(&acc->set, "call", NULL, skype_set_call, acc);
1175        s->flags |= ACC_SET_NOSAVE | ACC_SET_ONLINE_ONLY;
1176
1177        s = set_add(&acc->set, "balance", NULL, skype_set_balance, acc);
1178        s->flags |= ACC_SET_NOSAVE | ACC_SET_ONLINE_ONLY;
1179
1180        s = set_add(&acc->set, "skypeout_offline", "true", set_eval_bool, acc);
1181
1182        s = set_add(&acc->set, "skypeconsole", "false", set_eval_bool, acc);
1183        s->flags |= ACC_SET_OFFLINE_ONLY;
1184
1185        s = set_add(&acc->set, "skypeconsole_receive", "false", set_eval_bool,
1186                acc);
1187        s->flags |= ACC_SET_OFFLINE_ONLY;
1188
1189        s = set_add(&acc->set, "auto_join", "false", set_eval_bool, acc);
1190        s->flags |= ACC_SET_OFFLINE_ONLY;
1191}
1192
1193void init_plugin(void)
1194{
1195        struct prpl *ret = g_new0(struct prpl, 1);
1196
1197        ret->name = "skype";
1198        ret->login = skype_login;
1199        ret->init = skype_init;
1200        ret->logout = skype_logout;
1201        ret->buddy_msg = skype_buddy_msg;
1202        ret->get_info = skype_get_info;
1203        ret->set_my_name = skype_set_my_name;
1204        ret->away_states = skype_away_states;
1205        ret->set_away = skype_set_away;
1206        ret->add_buddy = skype_add_buddy;
1207        ret->remove_buddy = skype_remove_buddy;
1208        ret->chat_msg = skype_chat_msg;
1209        ret->chat_leave = skype_chat_leave;
1210        ret->chat_invite = skype_chat_invite;
1211        ret->chat_with = skype_chat_with;
1212        ret->handle_cmp = g_strcasecmp;
1213        ret->chat_topic = skype_chat_topic;
1214        register_protocol(ret);
1215}
Note: See TracBrowser for help on using the repository browser.