/purple-matrix

Libpurple protocol plugin for matrix
  1. C 99.3%
  2. Makefile 0.7%
C Makefile
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit 1a53f61 Sep 27, 2017 @ara4n ara4n Merge pull request #60 from radiocane/master 
[README] Add xenial-specific libglib package
Permalink
Failed to load latest commit information.
.settings Eclipse settings Oct 21, 2015
.gitignore Initial attempts at displaying a room in pidgin Oct 16, 2015
.project Eclipse settings Oct 21, 2015
AUTHORS.rst Enable room invites when matrix handle is known Jan 5, 2017
CHANGES.md Update AUTHORS/CONTRIBUTING/CHANGES Jan 4, 2016
CONTRIBUTING.rst Update AUTHORS/CONTRIBUTING/CHANGES Jan 4, 2016
LICENSE Initial commit Oct 13, 2015
Makefile Factor out common parts of Makefile and Makefile.mingw Jan 3, 2016
Makefile.common Factor out common parts of Makefile and Makefile.mingw Jan 3, 2016
Makefile.mingw Factor out common parts of Makefile and Makefile.mingw Jan 3, 2016
README.md [README] Add xenial-specific libglib package Sep 27, 2017
libmatrix.c Merge branch 'master' into typing-notifications3 May 28, 2017
libmatrix.h Invert the sense of the 'full_state' flag Nov 3, 2015
matrix-16px.png Install matrix icons Oct 22, 2015
matrix-22px.png Install matrix icons Oct 22, 2015
matrix-48px.png Install matrix icons Oct 22, 2015
matrix-api.c bump up max reply size Sep 2, 2017
matrix-api.h Responding to PR comments May 28, 2017
matrix-connection.c Re-use the device-id provided by the server Mar 11, 2017
matrix-connection.h Handle incoming room invites Nov 2, 2015
matrix-event.c event hooks Sep 2, 2016
matrix-event.h event hooks Sep 2, 2016
matrix-json.c Update README and file comments Oct 21, 2015
matrix-json.h Update README and file comments Oct 21, 2015
matrix-room.c Responding to PR comments May 28, 2017
matrix-room.h Responding to PR comments May 28, 2017
matrix-roommembers.c Hopefully fix bugs where the member list got out of sync Nov 3, 2015
matrix-roommembers.h Hopefully fix bugs where the member list got out of sync Nov 3, 2015
matrix-statetable.c Send/receive typing notifications Mar 12, 2017
matrix-statetable.h Handle incoming room invites Nov 2, 2015
matrix-sync.c Responding to PR comments May 28, 2017
matrix-sync.h Refactor the connection code Oct 22, 2015

README.md

purple-matrix

This project is a plugin for libpurple which adds the ability to communicate with matrix.org homeservers to any libpurple-based clients (such as Pidgin).

Status

This project is somewhat alpha, and only basic functionality has been implemented. Sending and receiving simple text messages is supported, as is joining rooms you are invited to by other users.

The following are not yet supported:

  • Creating new rooms (and one-to-one chats)
  • Joining existing rooms by alias instead of room_id
  • Presence indication
  • Typing indication
  • Videos/rich text in messages
  • Account registration
  • Room topics
  • Voice/video calling
  • End-To-End encryption via Olm (ticket)

The plugin requires a matrix homeserver supporting client-server API r0.0.0 Synapse v0.12.0-rc1 or later is sufficient.

Installation

Currently there are no pre-built binaries, so the plugin needs to be built from source.

You will need development headers/libraries for the following:

  • libpurple 2.x [libpurple-dev]
  • libjson-glib [libjson-glib-dev]
  • libglib [libglib-dev (or libglib2.0-dev on ubuntu 16.04 xenial)]
  • libhttp_parser [libhttp-parser-dev].

You should then be able to:

make
sudo make install

You will then need to restart Pidgin, after which you should be able to add a 'Matrix' account.

Building on Windows

Set up a build environment using the Pidgin BuildingWinPidgin docs

You should then be able to:

make -f Makefile.mingw
make -f Makefile.mingw install

You will then need to restart Pidgin, after which you should be able to add a 'Matrix' account.

Usage

  • Open the 'Manage accounts' dialog (under the 'Accounts' menu) and click 'Add'.
  • If the plugin was loaded successfully, you will be able to select 'Matrix' from the 'Protocol' dropdown.
  • Enter your matrix ID on the homeserver (e.g. '@bob:matrix.org' or 'bob') as the 'username', and the password in the 'password' field.
  • On the 'Advanced' tab, enter the URL of your homeserver.

The Advanced account option 'On reconnect, skip messages which were received in a previous session' is disabled by default. This means that pidgin will show the last few messages for each room each time it starts. If this option is enabled, only new messages will be shown.