lupine/purple-plugin-delta
1
0
Fork 0
Code Issues 6 Pull Requests Releases Wiki Activity
Files
3142134360a4471e8bd1e3e6ba62a09970ea1cd5
purple-plugin-delta/README.md

2.7 KiB
Raw Blame History

Delta Chat plugin for libpurple

Overview

Delta Chat is an instant messaging application based on email - which is to say, SMTP+IMAP.

Delta has:

This project is a libpurple plugin that wraps deltachat-core-rust, allowing a number of existing desktop and mobile clients to send and receive IMs over SMTP+IMAP. It may be useful for Linux-based mobile devices, for GUI desktop usage without an Electron dependency, or desktop usage.

Current status

Starting again from scratch in Rust. So currently, nothing works. TODO list:

  • [~] Connect to email account
  • Full settings support
  • Show buddy list
  • Send/receive text messages to single contact
  • Send/receive text messages to group chat
  • IMEX setup
  • Send/receive image messages
  • Send/receive audio messages
  • Send/receive video messages
  • Send/receive arbitrary attachments

Build

There are some licensing issues at present, so you shouldn't build this plugin.

deltachat-core-rust uses a vendored openssl 1, unconditionally links it, and is MPL-licensed.

purple-plugin-delta is GPLv3 without the OpenSSL exemption

libpurple itself is GPLv2 without the OpenSSL exemption.

There's no point to purple-plugin-delta adding the OpenSSL exemption because libpurple lacks it, and in any event, it will be unnecessary with the next major version of OpenSSL. So, time should resolve this for us one way or another.

Significant code using the WTFPL includes the libpurple-rust bindings and the pidgin-wechat plugin, which I'm taking a lot of inspiration from. WTF I like happens to include building it against this mess.

Use

The easiest way to use this is to copy the libdelta.so file into ~/.purple/plugins. When running pidgin, you'll now have the option to add a "Delta Chat" account.

At present, the "Username" and "Password" account fields correspond to email address and password, respectively. Many important settings also show up on the "Advanced" tab - if left blank, the plugin will attempt to automatically detect the correct values, but you may need to fill some of them in manually to get the connection to work.

Run pidgin with --debug to see interesting output.