Jabber: Difference between revisions

From AniDB
Jump to navigation Jump to search
Line 54: Line 54:


Sends an AniDB message to a user.
Sends an AniDB message to a user.
===msgread===
Marks the latest unread message as read. Please note that this might be a different message than the last one you received via jabber.
===msgread===
Marks the all unread messages as read.
===msglist===
Returns titles and senders for the latest five messages.


===subscribe===
===subscribe===
Line 77: Line 86:
displays the current version of the service
displays the current version of the service


===plugins===
displays the currently loaded plugins and their versions


==Future==
==Future==

Revision as of 22:23, 23 December 2006

This service is mainly a simple notification and anidb pm forward function implemented into jabber. This way you don't need to run additional software if you are already running a multinetwork Instant Messanger (Trillian, Miranda, Gaim, ...) or a standalone jabber client.

More about jabber: Wikipedia Jabber Entry

Features

Specifically it allows you to:

  • get your anidb pm in realtime
  • get your anidb notifications in realtime
  • send anidb pm via jabber
  • request fileinfo

Usage

  1. get a jabber client. (recommended is miranda, as it's a lightweight multinetwork client)
  2. get a jabber account
  3. add anidb@im.anidb.info as one of your contacts
  4. open a chatsession with it and type
subscribe <anidb username> <anidb password>
(without the <> of course)

Usage within GMail

Since Google Talk is basically a Jabber client, and GMail provides a "chat" component that interfaces with it, you can use it to access the AniDB Jabber Server from GMail.

  1. Open your GMail account on the browser.
  2. click on "Add Contact" (located on your Quick Contacts bar on the left side).
  3. enter anidb@im.anidb.info and click on "Send Invites".
  4. open a chatsession with it and type
subscribe <anidb username> <anidb password>
(without the <> of course)

Note: this method will try to send an email invitation to the AniDB Jabber Server. You'll receive one email with a delivery error message, which can be ignored with no ill effects.

General Information

To minimize the server load the AniDB Jabber Server will only send notifications and messages to users who are subscribed AND online. However, the AniDB Jabber Server will only be able to tell whether you are online or not, if you permit it to add you to it's contact list. You can check your current status with the status command. If your status is not listed as ONLINE, you will not receive any notifications/messages.

You can use the reactivate command to tell the AniDB Jabber Server to re-add you to it's contact list, should you for some reason have failed to grant it's first attempt.

Note that all actions are handed in batch jobs which can lead to a delay of one to five minutes, depending on the action. (i.e. your online status will not be updated in realtime)

Commands

help

Displays a list with all commands

file

file <fid>

Displays details for the file.

msg

msg <username> <message>

Sends an AniDB message to a user.

msgread

Marks the latest unread message as read. Please note that this might be a different message than the last one you received via jabber.

msgread

Marks the all unread messages as read.

msglist

Returns titles and senders for the latest five messages.

subscribe

subscribe <anidb username> <anidb password>

Enables you to receive AniDB Notify/PM messages in real time.

unsubscribe

Disables AniDB Notify/PM messages.

reactivate

Reactivates your subscription after suspension.

Currently this is only usefull if you have failed to grant the attempt of the AniDB Jabber Server to add you to it's contact list.

status

Displays your current subscription status.

The online status is especially important. You will not receive any notifications/messages if your status is not ONLINE. Take note that the status is not updated in real time. You should wait for about five minutes for it to update when you come online.

version

displays the current version of the service

plugins

displays the currently loaded plugins and their versions

Future

Will we add more features/commands?

Maybe, that depends on the demand. We might add support for most of Chii[AR]'s commands someday if there is enough interest among the AniDB userbase.