Next: , Previous: Chatting, Up: Basic operation

2.5 Presence

Presence is the Jabber term for letting other people know that you are online, and additionally how “available” you are. There are three elements to presence: availability state (called “show”), status message, and priority.

Your show state may either be empty (meaning simply “online”), or one of away, xa, dnd and chat, meaning “away”, “extended away” (i.e. away for an extended period), “do not disturb”, and “free for chat”, respectively. This information is available to everyone subscribing to your presence, but technically it does not restrict anyone's actions. You can chat with people even if you claim to be away.

The status message is a short text complementing your show status, such as “at home”, “working”, “phone”, “playing games” or whatever you want. It is sent to everyone subscribing to your presence, but not all clients prominently display it to the user.

The priority is only interesting if you are running more than one Jabber client at a time accessing the same account. See Resources and priority.

To set your presence, use the function jabber-send-presence (bound to C-x C-j C-p). It can be called both interactively and in Lisp code. For the latter case, use something like (jabber-send-presence "away" "idle for 10 minutes" 10). There are a few shortcuts:

C-x C-j C-a
Send “away” presence (with prefix argument, specify status text)
C-x C-j C-x
Send “extended away” presence (with prefix argument, specify status text)
C-x C-j C-o
Send default presence (see below)

By default, jabber.el sets your presence when you connect. If you want it not to do that, remove jabber-send-current-presence from jabber-post-connect-hooks. If you want to change the presence that is sent, change the variables jabber-default-show, jabber-default-status and jabber-default-priority.

With jabber.el, you can set your presence remotely. See Ad-Hoc Commands.