Description
Libpurple backend is backend based on Librpurple library supporting all the networks supported by libpurple.
Configuration
You have to choose this backend in Spectrum 2 configuration file to use it:
[service]
backend=/usr/bin/spectrum2_libpurple_backend
protocol=prpl-jabber
As showed above, there is also special configuration variable in [service] section called protocol which decides which Libpurple’s protocol will be used:
| Protocol variable | Description |
|---|---|
| prpl-jabber | Jabber |
| prpl-irc | IRC |
| prpl-gg | Gadu Gadu |
| prpl-novell | Groupwise |
Third-party plugins
Spectrum 2 should work with any third-party libpurple plugin which is properly installed. For example, popular plugins:
| Protocol variable | website | Description |
|---|---|---|
| prpl-facebook | https://github.com/jgeboski/purple-facebook | |
| telegram-tdlib | https://github.com/ars3niy/tdlib-purple | Telegram |
| prpl-hehoe-whatsmeow | https://github.com/hoehermann/purple-gowhatsapp | |
| prpl-skypeweb | https://github.com/EionRobb/skype4pidgin/tree/master/skypeweb | Skype |
| prpl-eionrobb-mattermost | https://github.com/EionRobb/purple-mattermost | Mattermost |
| prpl-eionrobb-discord | https://github.com/EionRobb/purple-discord | Discord |
These plugins are included by default in our Docker image.
Setting libpurple plugins configurations
Some libpurple protocol plugins allow setting configuration variables. Spectrum 2 passes every variable set in purple section to libpurple library. If you need to set such options, you can do it for example like this in your configuration file:
[purple]
clientlogin=1
ssl=0
Notes on Facebook support
- It may be a good idea to set up an application password instead of using your real credentials, for security alerts (and facebook paranoid security alerts) reasons.
- Facebook stickers are supported using Web Storage.
- Your XMPP client should support XEP-0085: Chat states to mark messages as read on the Facebook side. Otherwise, messages aren’t marked as read until you reply, and sometimes own messages aren’t either, so you should set
show-unread=0(see section above) if you want to avoid receiving duplicates - Group chats aren’t joined automatically. To join a group chat, get its ID through Facebook messenger’s web interface and join it as a
GROUP_CHAT_ID@your_facebook_transport.yourdomain.yourtld
Notes on Mattermost support
Some purple options are available to this specific backend :
[purple]
use-ssl = [0|1]
use-alias= [0|1]
use-mmauthtoken = [0|1] // to connect from gitlab service
show-full-images = [0|1]
show-images = [0|1]
- Mattermost account are set in mattermost group
- Use purple.use-mmauthtoken = 1 , if mattermost server use gitlab authenication
- Some trouble with channels https://github.com/EionRobb/purple-mattermost/issues/60 and https://github.com/SpectrumIM/spectrum2/issues/366
Notes on Discord support
To use discord from debian buster, backports packages is required
apt install purple-discord -t buster-backports
To manage connection and accept captcha link, harmony client must be installed on the server. Debian doesn’t provide an updated version. Script must be installed from source.
apt install python3-pip libcairo2-dev
pip3 install harmony-discord
Purple options are :
[purple]
show-custom-emojis = [1|0]
display-images = [0|1]
open-chat-on-mention = [1|0]
display-images-large-servers = [0|1]
populate-blist = [1|0]
use-status-as-game = [0|1]
use-status-as-custom-status= [1|0]
disable-compress = [0|1]