libpurple (Pidgin, Finch) protocol plugin for LINE – README.md

README.md

purple-line

libpurple (Pidgin, Finch) protocol plugin for LINE.

Screenshot

Install via package manager (Ubuntu/Debian)

An APT repository is available for installing the plugin. The repository contains the purple-line package itself, and the required Apache Thrift packages which are not properly packaged by either distribution.

The mirror is also available via SSL for secure access by using a https:// url.

For instructions for adding a custom repository on Ubuntu, see the Ubuntu wiki.

For Debian, see the Debian wiki, or just add the following line to your sources.list file:

deb http://debian.altrepo.eu/ code_name main

Replace code_name with your distribution specific codename. The codenames are listed in the debian.altrepo.eu wiki. In order to validate package signatures you need to add this public key to the APT key list. It can be done using the following command:

wget -qO - http://debian.altrepo.eu/altrepo_eu.pub | sudo apt-key add -

On either distribution, after adding the repository and key, run the following commands to install the plugin:

sudo apt-get update
sudo apt-get install purple-line

Install from source (Ubuntu/Debian)

apt-build enables you to install from source easily. You need to add a source entry to /etc/apt/sources.list. Run the following commands to install from source:

sudo apt-get install apt-build
echo "deb-src http://debian.altrepo.eu/ code_name main" | sudo tee -a /etc/apt/sources.list
echo "deb http://debian.altrepo.eu/ code_name main" | sudo tee -a /etc/apt/sources.list
sudo apt-get update
sudo apt-build install purple-line

Note that apt-build is not an official APT family program. If you install via source, your purple-line version will be up to date with the git repository. Note that the current git version may not have been tested on Ubuntu/Debian. The package will install known build dependencies, but if the git version requires new dependencies, compilation will fail.

Install from source (Arch Linux)

Arch Linux packages all the required dependencies and there's a PKGBUILD available (not yet in AUR). You can install the plugin by simply typing:

sudo pacman -S base-devel
curl -O http://altrepo.eu/git/arch.altrepo.eu/raw/master/purple-line/PKGBUILD
makepkg -cis

Install from source (any distribution)

Make sure you have the required prerequisites installed:

  • libpurple - Library that provides the core functionality of Pidgin and other compatible clients. Probably available from your package manager.
  • thrift - Apache Thrift compiler. May be available from your package manager.
  • libthrift - Apache Thrift C++ library. May be available from your package manager.
  • libgcrypt - Crypto library. Probably available from your package manager.

To install the plugin system-wide, run:

make
sudo make install

The makefile supports a flag THRIFT_STATIC=true which causes it to download and build a version of Thrift and statically link it. This should be convenient for people using one of the numerous distributions that do not package Thrift.

You can also install the plugin for your user only by replacing install with user-install.

Install on Windows

Pre-built binaries for Windows are available at Eion Robb’s website.

If you want to use purple-line with Pidgin or Finch, copy libline.dll into C:\Program Files (x86)\Pidgin\plugins\ and libgcrypt-20.dll & libgpg-error-0.dll into C:\Program Files (x86)\Pidgin\.

Features implemented

  • Logging in
    • Authentication
    • Fetching user profile
    • Account icon
    • Syncing friends, groups and chats
  • Send and receive messages in IM, groups and chats
  • Fetch recent messages
    • For groups and chats
    • For IMs
  • Synchronize buddy list on the fly
    • Adding friends
    • Blocking friends
    • Removing friends
    • Joining chats
    • Leaving chats
    • Group invitations
    • Joining groups
    • Leaving groups
  • Buddy icons
  • Editing buddy list
    • Removing friends
    • Leaving chats
    • Leaving groups
  • Message types
    • Text (send/receive)
    • Sticker (send via command/receive)
    • Image (send/receive)
    • Audio (send/receive)
    • Location (receive)

Features not yet implemented

  • Only fetch unseen messages, let a log plugin handle already seen messages
  • Implement timeouts for faster reconnections
  • Synchronize buddy list on the fly
    • Sync group/chat users more gracefully, show people joining/leaving
  • Editing buddy list
    • Adding friends (needs search function)
    • Creating chats
    • Inviting people to chats
    • Creating groups
    • Updating groups
    • Inviting people to groups
  • Changing your account icon
  • Message types
    • Audio/Video (send) File transfer API for sending?
    • Figure out what the other 15 message types mean...
  • Emoji (is it possible to tap into the smiley system for sending too?)
  • Companion Pidgin plugin
    • "Show more history" button
    • Sticker list
    • Open image messages
    • Open audio messages
    • Open video messages
  • Sending/receiving "message read" notifications
  • Check builds on more platforms
  • Packaging