/slack-libpurple

Slack module for libpurple

Primary LanguageCGNU General Public License v2.0GPL-2.0

slack-libpurple Build Status

A Slack protocol plugin for libpurple IM clients.

Here's how slack concepts are mapped to purple:

  • Your "open" channels (on the slack bar) are mapped to the buddy list: joining a channel is equivalent to creating a buddy
  • Which conversations are open in purple is up to you, and has no effect on slack... (how to deal with activity in open channels with no conversation?)
  • For bitlbee IRC connections, Slack channels are "chat channels" that can be added to your configuration with "chat add <account id> #<channel>"
  • TBD... feedback welcome

Installation/Configuration

  1. Install libpurple (pidgin, finch, etc.), including necessary development components on binary distros (libpurple-devel, libpurple-dev, etc.)
  2. Run sudo make install or make install-user

Authentication

To login enter your email address as the username and ${WORKSPACE}.slack.com as the host. You can also optionally enter your password and have it saved.

Legacy Authentication

Earlier versions of this plugin used Slack's legacy tokens for authentication. This feature is still supported, but as Slack will be stopping the creation of legacy tokens on May 5th 2020, it is highly advised that you migrate to the username/password authentication from above.

  1. Issue a Slack API token for yourself
  2. Add your slack account to your libpurple program and enter this token under (Advanced) API token (do not enter your slack password; username/hostname are optional but can be set to you@your.slack.com)

If you're using a front-end (like Adium or Spectrum2) that does not let you set the API token, you can enter your token as the account password instead.

@EionRobb is kindly providing windows builds here.