Skip to content
Windows Toast Notification Plugin for Pidgin
C++ C
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
Plugin Bumped version to 1.6.1 Apr 4, 2019
img Added supported Pidgin versions and latest features to Readme Apr 4, 2019
lib Changed app id to "Pidgin.Pidgin" Jun 8, 2018
CHANGELOG.md Bumped version to 1.6.1 Apr 4, 2019
LICENSE Added GPLv2 License Apr 6, 2018
README.md

README.md

PidginWinToastNotifications

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 with picture

Direct message from someone who has not a profile picture:

Direct message without picture

Chat message from someone who has not a profile picture:

Chat message without picture

A buddy who has not a profile picture signed on:

Buddy signed on

A buddy who has not a profile picture signed off:

Buddy signed off

This plugin uses Pidgin's standard C API so no other tools like Perl are required.

Table of contents

Configuration

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).

Global configuration:

Global configuration

It is also possible to overwrite the global settings for each group, chat and buddy.

Configuration for a group:

Group configuration

Configuration for a chat:

Chat configuration

Configuration for a buddy:

Buddy configuration

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:

Configuration menu in a conversation

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.

Changelog

All changes between versions are documented in the file CHANGELOG.md.

Installation

  1. Download the dll files from the newest release.
  2. 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.
  3. 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.
  4. Start Pidgin. Open the plugin window and enable "Windows Toast Notifications".

Architecture

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

PidginWinToastNotifications.dll

This file is build using the GNU Compiler Collection (GCC).

  1. Follow the official instructions of the Pidgin wiki to set up your build environment. For this I recommend pidgin-windev.
  2. Copy the files Plugin/PidginWinToastNotifications.h and Plugin/PidginWinToastNotifications.c into the subfolder pidgin\plugins inside of your Pidgin development directory.
  3. Inside a Cygwin Terminal navigate to pidgin\plugins inside of your Pidgin development directory.
  4. Run the Command: make -f Makefile.mingw PidginWinToastNotifications.dll

Now the file PidginWinToastNotifications.dll should be in the same folder.

PidginWinToastLib.dll

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.

You can’t perform that action at this time.