Jabber

From AniDB
Revision as of 13:31, 16 May 2009 by Foo2 (talk | contribs)
Jump to navigation Jump to search

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 multi-network Instant Messenger (Trillian, Miranda, Pidgin, ...) or a standalone Jabber client.

More about Jabber: Wikipedia Jabber Entry

Features

Specifically it allows you to:

  • get your AniDB pm in real time
  • get your AniDB notifications in real time
  • 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. enter your Jabberaccount in _lower case_ in your profile in AniDB
  4. add anidb@im.anidb.net as one of your contacts
  5. 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. enter your Jabberaccount in _lower case_ in your profile in AniDB
  2. Open your GMail account on the browser.
  3. click on "Add Contact" (located on your Quick Contacts bar on the left side).
  4. enter anidb@im.anidb.net and click on "Send Invites".
  5. 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. If your status won't change to ONLINE but is stuck at INACTIVE, check if you have entered your Jabber ID in lower case only (in your profile on the AniDB site and in your Jabber client).

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 real time)

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.

msgreadall

Marks 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 useful 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.