/purple-mattermost

A libpurple/Pidgin plugin for Mattermost (STALE: look the upstream, dev. happens there)

Primary LanguageCGNU General Public License v3.0GPL-3.0

V4 API note:

V4 API implementation is Work In Progress: in particular following does not work and/or is buggy:

  • chat history is limited to (first) 200 messages
  • ...

Pidgin-Mattermost plugin by Eion Robb

Connects libpurple-based instant messaging clients (such as Pidgin, Finch, Adium, bitlbee) with Mattermost server.

Features

Setup & Navigation

  • Installer for setting up Pidgin-Mattermost with Pidgin.
  • Connect to Mattermost server using email/username & password.
  • Connect to Mattermost server using AD/LDAP credentials.
  • Connect to Mattermost server using GitLab cookie authentication (MMAUTHTOKEN workaround).
  • Automatically add buddies and joined channels to buddylist and keeps the list in sync with the server.
  • Automatically keeps chat topic in sync with the server.
  • Add/Remove buddies.
  • User search via Accounts > {Mattermost Account} > Search for Users...
  • Channel search via Accounts > {Mattermost Account} > Room List

Not implemented yet:

  • Add/Remove chats.
  • ...

Core Communication

  • Send and receive messages, including weblinks and emoji.
  • Display of online/offline/away status.
  • Sending of read notifications so the server understands users is still online.
  • Display of messages sent while Pidgin was offline.
  • Mark messages edited by a Mattermost user as "Edited:"
  • If Mattermost enables public file links (off by default) file sharing links can be displayed in Pidgin.
  • Display of emojis (install Pidgin EmojiOne smileys theme)

Group Discussions

  • Join a public and private channels and multi-party direct message channels by right-clicking on channel in Buddy List and selecting.

1-1 Discussions

  • Open Direct Message discussions from a Room by right-clicking on the user name and selecting IM.

Advanced Mattermost Features

Screenshots

s

End User Install Guides

Please see install guides for setting up Pidgin-Mattermost

This plugin includes it own installer for setting up on Windows:

s

Developer Install Guide

For modifying or extending this project please follow the Linux Client Install Guide to set up your environment.

Changelog

  • April 18, 2017 - Pidgin-Mattermost v0.0 - Project started
  • April 23, 2017 - Pidgin-Mattermost v1.0 - Initial Release

Verification

The following table outlines the results of verification tests completed on different client platforms.

Version Verification Plan Analyst Verification Date Bugs Found
Pidgin 1.0 Win10 Tests v1.0 Ian Tien April 23, 2017 #4

Contributions to testing and verifying this projects are highly welcome, read our verification contributions documentation to learn how you can help.