Windows toast notification plugin for Pidgin.
Shows notifications on message receive or buddy sign on / off in the standard Windows design.
Direct message from someone who has a profile picture:
Direct message from someone who has not a profile picture:
Chat message from someone who has not a profile picture:
A buddy who has not a profile picture signed on:
A buddy who has not a profile picture signed off:
This plugin uses Pidgin's standard C API so no other tools like Perl are required.
Table of contents
- Table of contents
- Supported operating systems
- Supported Pidgin versions
- Help and feature requests
- How to build on Windows
It can be configured if notifications should be shown for direct messages, every message in chats, only for messages in chats when mentioned or only if the conversation window is not focused.
It is also possible to configure if a notification should be shown when a buddy signed on or off.
This configuration can be overwritten per status (Available, Away, Do not disturb, Extended away or Invisible).
It is also possible to overwrite the global settings for each group, chat and buddy.
Configuration for a group:
Configuration for a chat:
Configuration for a buddy:
The global configuration can be accessed via the default plugin configuration page (In Buddy List: Tools / Plugins / Windows Toast Notifications).
The group settings can be opened from the context menu of a group in the Buddy List.
The local settings can be opened from the conversation menu underneath More or from the context menu of a buddy or chat in the Buddy List:
Supported operating systems
The plugin was developed and tested using the newest Windows 10 version.
Other Windows 10 versions, Windows 8 and Windows 8.1 should also work, but this has not been tested.
To display the protocol, account and chat name in the toast notifications the Windows 10 Anniversary Update (also known as version 1607 or Redstone 1) or newer is required.
Supported Pidgin versions
The plugin was developed and tested using the newest Pidgin 2 version.
Other Pidgin versions may work, but this has not been tested.
If a problem occurs, try updating Pidgin to the latest 2.X.X version.
Help and feature requests
If you experience a problem or have an idea for a new feature, feel free to open an issue.
All changes between versions are documented in the file CHANGELOG.md.
- Download the dll files from the newest release.
- Copy the file PidginWinToastLib.dll to the installation directory of Pidgin. This is usually "C:\Program Files (x86)\Pidgin" on 64-bit versions of Windows or "C:\Program Files\Pidgin" on a 32-bit version.
- Copy the file PidginWinToastNotifications.dll to the plugin directory of Pidgin. This is usually "C:\Program Files (x86)\Pidgin\plugins" on 64-bit versions of Windows or "C:\Program Files\Pidgin\plugins" on a 32-bit version.
- Start Pidgin. Open the plugin window and enable "Windows Toast Notifications".
This Plugin consists of the two dll files PidginWinToastNotifications.dll and PidginWinToastLib.dll.
PidginWinToastNotifications.dll is loaded from Pidgin as plugin. It is written in ANSI C and it provides necessary plugin information. It registers callback functions in Pidgin's message API and relays received messages to PidginWinToastLib.dll.
PidginWinToastLib.dll is written in C++ and calls Windows's toast notification API to display the toast notifications. For that it uses WinToast as library.
How to build on Windows
This file is build using the GNU Compiler Collection (GCC).
- Follow the official instructions of the Pidgin wiki to set up your build environment. For this I recommend pidgin-windev.
- Copy the files Plugin/PidginWinToastNotifications.h and Plugin/PidginWinToastNotifications.c into the subfolder pidgin\plugins inside of your Pidgin development directory.
- Inside a Cygwin Terminal navigate to pidgin\plugins inside of your Pidgin development directory.
- Run the Command: make -f Makefile.mingw PidginWinToastNotifications.dll
Now the file PidginWinToastNotifications.dll should be in the same folder.
This file is build using Visual Studio 2017.
Open the Solution lib/PidginWinToastLib.sln in Visual Studio 2017. Right click on the Project and hit Build.
Now the file PidginWinToastLib.dll should be in the Release folder of your Solution.