====== Psi+ Plugins ======

===== Changes in Psi plugins system ======

  * Ability to read and write settings from plugins, by [[https://github.com/ch|C.H.]]
  * Ability to add shortcuts from plugins
  * Ability to add and receive icons, by [[https://github.com/VampiRUS|VampiRUS]] and [[https://github.com/wadealer|Dealer_WeARE]]
  * Access to the parameters of the active tab, by [[https://github.com/VampiRUS|VampiRUS]]
  * Access to different information about the application
  * Access to account information - by [[https://github.com/wadealer|Dealer_WeARE]]
  * Ability to call popups from plugins, by [[https://github.com/wadealer|Dealer_WeARE]]
  * Ability to change the events from plugins (method `processEvent` in Juick plugin and Gmail Service Plugin), by [[https://github.com/VampiRUS|VampiRUS]]
  * Ability to add buttons to the toolbar to calling plugin methods (//ToolbarIconAccessor//, //GCToolbarIconAccessor// in Image Plugin), by [[https://github.com/VampiRUS|VampiRUS]]
  * Ability to add buttons for calling plugin methods from the account menu header and from the roster contact menu, by [[https://github.com/wadealer|Dealer_WeARE]]
  * Ability to change the mood, activity and user tune for a specified contact (needed for the Qip X-statuses plugin to work), by [[https://github.com/wadealer|Dealer_WeARE]]








===== Plugin compilation example =====

Consider the example of the [[plugins#conference_logger_plugin|Conference Logger Plugin]]:

  * Download the Psi source code from the git repository ([[git://git.psi-im.org/psi.git]])
  * Apply Psi+ patches to the source code of Psi
  * Download the plugin source code to the **psi/src/plugins/generic/conferenceloggerplugin** directory
  * Execute the command **qmake conferenceloggerplugin.pro**
  * Execute the command **make -f makefile.release** (for win32: **mingw32-make -f makefile.release**)
  * The result of the build will be the release version of the Conference Logger Plugin can be found in the **psi/src/plugins/generic/conferenceloggerplugin/release** directory.



















===== Plugins from the Psi+ Project =====

|| {{:attention.png}} [[plugins#Attention_Plugin|Attention Plugin]] ||
|| {{:autoreply.png}} [[plugins#Autoreply_Plugin|Autoreply Plugin]] ||
|| {{:birthday.png}} [[plugins#Birthday_Reminder_Plugin|Birthday Reminder Plugin]] ||
|| {{:captcha.png}} [[plugins#Captcha_Forms_Plugin|Captcha Forms Plugin]] ||
|| {{:chess.png}} [[plugins#Chess_Plugin|Chess Plugin]] ||
|| {{:cleaner.png}} [[plugins#Cleaner_Plugin|Cleaner Plugin]] ||
|| {{:clientswitcher.png}} [[plugins#Client_Switcher_Plugin|Client Switcher Plugin]] ||
|| {{:openlog.gif}} [[plugins#Conference_Logger_Plugin|Conference Logger Plugin]] ||
|| {{:download.png}} [[plugins#Content_Downloader_Plugin|Content Downloader Plugin]] ||
|| {{:extendedmenu.png}} [[plugins#Extended_Menu_Plugin|Extended Menu Plugin]] ||
|| {{:extendedoptions.png}} [[plugins#Extended_Options_Plugin|Extended Options Plugin]] ||
|| {{:gmailnotify.png}} [[plugins#Gmail_Service_Plugin|Gmail Service Plugin]] ||
|| {{:gomoku.png}} [[plugins#Gomoku_Game_Plugin|Gomoku Game Plugin]] ||
|| {{:historykeeper.png}} [[plugins#History_Keeper_Plugin|History Keeper Plugin]] ||
|| {{:icqdie.png}} [[plugins#ICQ_Must_Die_Plugin|ICQ Must Die Plugin]] ||
|| {{:imageplugin.gif}} [[plugins#Image_Plugin|Image Plugin]] ||
|| {{:jabberdisk.png}} [[plugins#XMPP_Disk_Plugin|XMPP Disk Plugin]] ||
|| {{:juick.png}} [[plugins#Juick_Plugin|Juick Plugin]] ||
|| {{:pepchangenotify.png}} [[plugins#PEP_Change_Notify_Plugin|PEP Change Notify Plugin]] ||
|| {{:qipxstatuses.png}} [[plugins#Qip_X-statuses_Plugin|Qip X-statuses Plugin]] ||
|| {{:screenshot.png}} [[plugins#Screenshot_Plugin|Screenshot Plugin]] ||
|| {{:skins.png}} [[plugins#Skins_Plugin|Skins Plugin]] ||
|| {{:stopspam.png}} [[plugins#Stop_Spam_Plugin|Stop Spam Plugin]] ||
|| {{:storagenotes.png}} [[plugins#Storage_Notes_Plugin|Storage Notes Plugin]] ||
|| {{:translate.png}} [[plugins#Translate_Plugin|Translate Plugin]] ||
|| {{:videostatus.png}}[[plugins#Video_Status_Changer_Plugin|Video Status Changer Plugin]] ||
|| {{:watcher.png}} [[plugins#Watcher_Plugin|Watcher Plugin]] ||

<del>
__**Importantly**__: Psi+ plugins are **incompatible** with official version of Psi.</del>











==== Attention Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

{{:psiplus_plugins_attentionplugin001.png|Popup window with notice}}

{{:psiplus_plugins_attentionplugin002.png|Window with plugin settings}}

This plugin is designed to send and receive special messages such as Attentions.

To work correctly, the plugin requires that the client of the other party supports //[[http://xmpp.org/extensions/xep-0224.html|XEP-0224]]// (for example: Pidgin, Miranda IM with //[[http://addons.miranda-im.org/details.php?action=viewfile&id=2708|Nudge]]// plugin).

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/attentionplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/attentionplugin/|here]].









==== Autoreply Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

{{:psiplus_plugins_autoreplyplugin.png}}

This plugin acts as an auto-answering machine. It has a number of simple configuration options, which you can use to:

  * set a text message for auto-answer
  * exclude specified jids, including conferences, from the objects for auto-answer (if a jid conference is set, the exception will include all private messages)
  * disable the auto-responder for some of your accounts
  * set the number of sent auto messages
  * set the time interval after which the number of auto messages counter will be reset
  * disable the auto-responder for the active tab
  * disable the auto-responder for contacts that are not in your roster

The list of exceptions for jids has two operating modes:

  * auto-responder is _switched off_ for the list of exceptions, for the others is _switched on_ (Disable mode)
  * auto-responder is _switched on_ for the list of exceptions, for the others is _switched off_ (Enable mode)

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/autoreplyplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/autoreplyplugin/|here]].











==== Birthday Reminder Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to show reminders of upcoming birthdays.

{{:psiplus_plugins_birthdayreminderplugin002.png|Window with plugin settings}}

The first time you install this plugin, you need to log on to all of your accounts, go to the plugin settings and click "Update Birthdays". The plugin will then collect the information about the birthdays of all the users in your roster, but when the 'Use vCards cache' option is selected, the users' vCards that are cached on your hard disk will be used.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/birthdayreminderplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/birthdayreminderplugin/|here]].









==== Captcha Forms Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to pass of captcha directly from the Psi+.

At the moment the functional is very limited. It only works if the image is sent directly to the body of the message (download content from Internet does not work).

{{:psiplus_plugins_captchaformsplugin.png|Form with captcha}}

{{:psiplus_plugins_captchaformsplugin002.png|Window with plugin settings}}

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/captchaformsplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/captchaformsplugin/|here]].







==== Chess Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

{{:psiplus_plugins_chessplugin.png}}

This plugin allows you to play chess with your friends.

The plugin is compatible with a similar plugin for [[http://tkabber.jabber.ru/|Tkabber]].

For sending commands, normal messages are used, so this plugin will always work wherever you are able to log in.

To invite a friend for a game, you can use contact menu item or the button on the toolbar in a chat window.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/chessplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/chessplugin/|here]].










==== Cleaner Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to clear the avatar cache, saved local copies of vCards and history logs.

{{:psiplus_plugins_cleanerplugin.png}}

You can preview items before deleting them from your hard drive.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/cleanerplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/cleanerplugin/|here]].






















==== Client Switcher Plugin ====

Author: //[[https://github.com/liuch|liuch]]//

This plugin is intended to spoof version of the XMPP client, the name and type of operating system. It is possible to manually specify the version of the client and the operating system or choose from a predefined list.

{{:psiplus_plugins_clientswitcherplugin001.png|}}

__**Note**__: It is recommended to use the plugin only when really necessary. Keep in mind that the substitution of the name and version of the client may have a negative impact on support in their respective conferences.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/clientswitcherplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/clientswitcherplugin/|here]].


































==== Conference Logger Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to save conference logs in which the Psi+ user sits.

{{:psiplus_plugins_conferenceloggerplugin.png}}

Conferences logs can be viewed from the plugin settings or by clicking on the appropriate button on the toolbar in the active window/tab with conference.

__**Note**__: To work correctly, the option **options.ui.chat.central-toolbar** must be set to **true**.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/conferenceloggerplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/conferenceloggerplugin/|here]].












==== Content Downloader Plugin ====

Author: //[[https://github.com/drizt|taurus]]//

This plugin is designed to make it easy to download and install iconsets and other resources for Psi+.

{{:psiplus_plugins_contentdownloaderplugin002.png}}

This plugin can currently be used to download and install roster iconsets and emoticons.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/contentdownloaderplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/contentdownloaderplugin/|here]].















==== Extended Menu Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin adds roster submenu 'Extended Actions' to contact's context menu. At the moment we have the following items: 'Copy JID', 'Copy the nickname', 'Copy the status message' and 'Ping'.

{{:psiplus_plugins_extendedmenuplugin.png|psiplus_plugins_extendedmenuplugin.png}}

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/extendedmenuplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/extendedmenuplugin/|here]].





























==== Extended Options Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to allow easy configuration of some advanced options in Psi+.

This plugin gives you access to advanced application options, which do not have a graphical user interface.

{{:psiplus_plugins_extendedoptionsplugin.png}}

__**Importantly**__: A large part of the options are important system settings. These require extra attention and proper understanding of the results when changing the option.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/extendedoptionsplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/extendedoptionsplugin/|here]].










==== Gmail Service Plugin ====

Author: //[[https://github.com/VampiRUS|VampiRUS]]//, //[[https://github.com/wadealer|Dealer_WeARE]]//

Shows notifications of new messages in your [[http://mail.google.com/mail/|Gmailbox]].

{{:psiplus_plugins_gmailnotifyplugin.png}}

__**Note**__: The plugin only checks the root of your Inbox folder in your Gmailbox for new messages. When using server side mail filtering, you may not be notified about all new messages.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/gmailserviceplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/gmailserviceplugin/|here]].








==== History Keeper Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to remove the history of selected contacts when the Psi+ is closed.

{{:psiplus_plugins_historykeeperplugin.png}}

You can select or deselect a contact for history removal from the context menu of a contact or via the plugin options.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/historykeeperplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/historykeeperplugin/|here]].











==== ICQ Must Die Plugin ====

Author: //[[https://github.com/ivan1986|ivan1986]]//

{{:psiplus_plugins_icqdieplugin002.png|Window with plugin settings}}

This plugin is designed to help you transfer as many contacts as possible from ICQ to XMPP.

The plugin has a number of simple settings that can help you:

  * Set a special message text
  * Exclude specific ICQ numbers
  * Set the time interval after which the message will be repeated
  * Disable the message for the active window/tab
  * Disable messages for contacts that are not in your roster

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/icqdieplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/icqdieplugin/|here]].









==== Image Plugin ====

Author: //[[https://github.com/VampiRUS|VampiRUS]]//

This plugin is designed to send images to roster contacts.

{{:psiplus_plugins_imageplugin.png}}

Your contact's client must be support //[[http://xmpp.org/extensions/xep-0071.html|XEP-0071: XHTML-IM]]// and support the **data:URI** scheme.

__**Note**__: To work correctly, the option **options.ui.chat.central-toolbar** must be set to **true**.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/imageplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/imageplugin/|here]].










==== Juick Plugin ====

Author: //[[https://github.com/VampiRUS|VampiRUS]]//

This plugin is designed to work efficiently and comfortably with the **[[http://juick.com/|Juick]]** microblogging service.

{{:psiplus_plugins_juickplugin.png}}

Currently, the plugin is able to:

  * Coloring **@nick**, ***tag** and **#message_id** in messages from the **juick@juick.com** bot
  * Detect //>quotes// in messages
  * Enable clickable **@nick**, ***tag**, **#message_id** and other control elements to insert them into the typing area

__**Note**__: To work correctly, the option **options.html.chat.render** must be set to **true**.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/juickplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/juickplugin/|here]].












==== PEP Change Notify Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

The plugin is designed to display popup notifications on change of moods, activities and tunes at the contacts of the roster. In the settings you can choose which ones to include notification of events, specify the time within which a notice will appear, as well as play a sound specify.

{{:psiplus_plugins_pepchangenotifyplugin001.png|}}

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/pepchangenotifyplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/pepchangenotifyplugin/|here]].






















==== Qip X-statuses Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to display [[http://wiki.qip.ru/X-статус|X-statuses]] of contacts using the [[http://qip.ru/ru/pages/download_infium_ru/|QIP Infium]] jabber client.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/qipxstatusesplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/qipxstatusesplugin/|here]].











==== Screenshot Plugin ====

Authors: //[[https://github.com/ch|C.H.]], [[https://github.com/wadealer|Dealer_WeARE]]//

This plugin allows you to make a snapshot (screenshot) of the screen, edit the visible aria to make a screenshot and save the image to a local drive or upload to HTTP/FTP server.

{{:psiplus_plugins_screenshotplugin001.png}}

{{:psiplus_plugins_screenshotplugin002.png}}

The plugin has the following settings:

  * **Shortcut** -- Hotkey to call the plugin (//Ctrl + Alt + P// by default)
  * **Format** -- type of image file, which will save a snapshot of the screen (//png// by default)
  * **File Name** -- format of the filename (default: //pic-yyyyMMdd-hhmmss//, where //yyyyMMdd//=YYYYMMDD, and //hhmmss// are current date in the format //yearmonthday-hourminutesecond//; for example, //pic-20100711-135132.png//)

The address of FTP server is specified as //[[ftp://ftp.domain.tld/path1/path2]]//.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/screenshotplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/screenshotplugin/|here]].









==== Skins Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to create, store and apply skins to Psi+.

{{:psiplus_plugins_skinsplugin.png|Windows with screenshots of skin}}

{{:psiplus_plugins_skinsplugin002.png|Window with plugin settings}}

**Skin** -- a set of custom settings.

In order to apply a new skin for Psi+ you can use different methods:

  * Create in the //PsiData// folder **skins** directory and position it previously downloaded skin (by default the plugin looks in the directory //PsiData//)
  * Open a file from anywhere on the skin of a local disk using the **Open** command in the plugin settings

Each skin must be in a separate directory. You can also add a screenshot to the skin file.

In most cases, to be sure that the skin is applied correctly, you must perform a sequence of actions:

  * Apply the skin
  * Restart the application
  * Apply the same skin again

This will enable all settings (icons, toolbars, status) to pick up correctly.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/skinsplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/skinsplugin/|here]].










==== Stop Spam Plugin ====

Автор: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to block spam messages and other unwanted information from Psi+ users.

{{:psiplus_plugins_stopspamplugin001.png|Window with plugin main settings}}

The functionality of the plugin is based on the principle of "question - answer".

With the plugin settings you can:

  * Define a security question and the answer
  * Define the set of rules that define whether to the trigger plugin for a contact
  * Define the text messages sent in the case of the correct answer
  * Enable notification through popups
  * Enable the saving of blocked messages in the history of the contact
  * Define the number of subject parcels
  * Set the time interval after which to reset the number of how many questions will be sent
  * Enable blocking of private messages in conferences
  * Choose for which ranks and roles of conference participants blocking messages will be disabled
  * Enable deadlocks in private messages to participants who do not fall into the exceptions list for the roles and ranks which include blocking.

The rules are checked from top to bottom. If the rule is //Enabled// - stopspam is triggered, otherwise - stopspam is not triggered. In the case where none of the rules triggered stopspam for roster messages, you can specify whether the plugin will activate or not. For private messages from the same conference, it will always work.

Question and answer as well as a list of rules is common for ordinary messages and for private messages in conferences.

When a user has passed, the test will send a re-authorization request. It should be noted in the messages that are sent back the security question was correctly answered.

The plugin keeps a log of blocked messages, which you can view through the plugin settings.

{{:psiplus_plugins_stopspamplugin002.png|Window with plugin additional settings}}

The **Reset** button deletes the log and resets the counter of blocked messages.

__**WARNING!!! Before registering a new transport, it is recommended to add its jid to transport exceptions. This is due to the fact that after the transport registration, authorization requests for all contacts will be sent and if the transport was not added to as an exception, the plugin will block all the requests**__.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/stopspamplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/stopspamplugin/|here]].













==== Storage Notes Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is an implementation of //[[http://xmpp.org/extensions/xep-0049.html|XEP-0049: Private XML Storage]]//.

{{:psiplus_plugins_storagenotesplugin001.png}}

{{:psiplus_plugins_storagenotesplugin002.png}}

The plugin is fully compatible with notes saved using [[http://www.miranda-im.org/|Miranda IM]].

The plugin is designed to keep notes on the jabber server with the ability to access them from anywhere using Psi+ or Miranda IM.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/storagenotesplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/storagenotesplugin/|here]].











==== Translate Plugin ====

Author: //[[https://github.com/VampiRUS|VampiRUS]]//

This plugin allows you to convert selected text into another language.

{{:psiplus_plugins_translateplugin001.png|Window with plugin settings}}

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/translateplugin/|here]].









==== Video Status Changer Plugin ====

Authors: //[[https://github.com/wadealer|Dealer_WeARE]], [[https://github.com/Vitozz|KukuRuzo]]//

{{:psiplus_plugins_videostatusplugin.png}}

This plugin is designed to set the custom status when you see the video in selected video player.

Communication with players made by [[http://en.wikipedia.org/wiki/D-Bus|D-Bus]].

__**Note**__: This plugin is designed to work in Linux family operating systems __**ONLY**__.

  * To work with Totem player you need to enable appropriate plugin in this player (Edit\Plugins\D-Bus)
  * To work with VLC player you need to enable the option "Control Interface D-Bus" in the Advanced Settings tab on "Interface\Control Interface" section of the player settings
  * To work with Kaffeine player you must have player version (>= 1.0), additional configuration is not needed
  * To work with GNOME MPlayer additional configuration is not needed

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/videostatusplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/videostatusplugin/|here]].










==== Watcher Plugin ====

Author: //[[https://github.com/wadealer|Dealer_WeARE]]//

This plugin is designed to monitor the status of specific roster contacts, as well as for substitution of standard sounds of incoming messages.

On the first tab set up a list of contacts for the status of which is monitored. When the status of such contacts changes a popup window will be shown and when the status changes to online a custom sound can be played.

{{:psiplus_plugins_watcherplugin001.png}}

On the second tab is configured list of items, the messages are being monitored.

{{:psiplus_plugins_watcherplugin002.png}}

Each element can contain a regular expression to check for matches with JID, from which the message arrives, a list of regular expressions to check for matches with the text of an incoming message, the path to sound file which will be played in case of coincidence, as well as the setting, whether the sound is played always, even if the global sounds off.

Detailed version history can be found [[https://github.com/psi-plus/plugins/blob/master/generic/watcherplugin/changelog.txt|here]].

The plugin source code can be found [[https://github.com/psi-plus/plugins/blob/master/generic/watcherplugin/|here]].












===== Binary versions of Psi+ Plugins =====

Ready-to-use version of the Psi+ Plugins for various OSs can be downloaded from **[[downloads#psi_plugins|here]]**.