poezio/doc/source/misc/personal_events.rst

74 lines
1.6 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Personal Events
===============
Starting from poezio 0.8, poezo now supports `user mood`_, `user activity`_,
`user tune`_, and `user gaming`_.
Those extensions are standardized ways to broadcast informations that might be
useful to your contacts (they will receive those informations only if they
have indicated their interest in them).
You can see below the list of the related options and commands.
.. note::
All the *display_foo_notifications* options can be tab-specific, so you
can display those notifications only for a specific contact, or the
other way around.
User Mood
~~~~~~~~~
Options:
- :term:`enable_user_mood`
- :term:`display_mood_notifications`
Commands:
- :term:`/mood`
User Activity
~~~~~~~~~~~~~
Options:
- :term:`enable_user_activity`
- :term:`display_activity_notifications`
Commands:
- :term:`/activity`
User Gaming
~~~~~~~~~~~
Options:
- :term:`enable_user_gaming`
- :term:`display_gaming_notifications`
Commands:
- :term:`/gaming`
User Tune
~~~~~~~~~
Options:
- :term:`enable_user_tune`
- :term:`display_tune_notifications`
.. note::
There is no /tune command because it wouldnt be really useful.
There was originally a way to broadcast the current tune with the
mpd plugin, but it was no good. You should use an external script
to do that, or use a player that has the feature.
.. _user mood: http://xmpp.org/extensions/xep-0107.html
.. _user tune: http://xmpp.org/extensions/xep-0118.html
.. _user gaming: http://xmpp.org/extensions/xep-0197.html
.. _user activity: http://xmpp.org/extensions/xep-0108.html