Configuring a Jabber client to access Citadel

Citadel's instant messenger functions may be accessed using your favorite XMPP (Jabber) client.  This makes it very easy to keep in touch with other Citadel users around the clock by seamlessly integrating it into your desktop experience.  You can also use a Jabber client on your smartphone or other devices, carrying Citadel with you everywhere.

These instructions are for Pidgin, a popular open source client available for all platforms.  If you are using some other client, please perform whatever configuration steps are equivalent to these.

First, start up Pidgin:

Select "Accounts --> Manage Accounts" and then click "Add".

Enter the following information:

• Username: use your account name on the Citadel server.  If your name contains spaces, you may simply leave them out.  (Citadel considers spaces and punctuation insignificant in usernames; for example, "ignatiustfoobar" is the same as "IGnatius T Foobar" or "ignatius.t.foobar")
• Domain: enter the fully qualified domain name of your Citadel server.
• Resource: this is optional, but you might enter something that identifies the client if you're using several of them; for example "home" or "work" or "mobile".
• Password: enter your password for the Citadel server, and select "Remember password" if you don't want to be asked for it every time you start up Pidgin.
  

The account is now configured.  Make sure it is "enabled" in Pidgin, and you are logged in.

Now your Citadel companions will appear in your instant messenger program!  You don't have to worry about maintaining a buddy list.  Since Citadel sites tend to be accessed by small groups of people, your buddy list will simply appear as a list of everyone currently logged into the server.