Adds support for Telegram to Pidgin, Adium, Finch and other Libpurple based messengers.
Find a file
2014-10-04 20:32:59 +02:00
purple-plugin Add a nicer description 2014-10-04 20:32:59 +02:00
telegram-adium Add xCode project files for an Adium telegram plugin 2014-10-04 20:32:59 +02:00
.gitignore Add makefile 2014-10-02 14:17:36 +02:00
.travis.yml Update build tool dependencies and add a new configure 2014-09-20 18:13:02 +02:00
binlog.c Improve logging system 2014-10-03 14:23:15 +02:00
binlog.h Remove unused binlog functions 2014-10-02 13:01:28 +02:00
binlog.tl Added files for binlog 2013-11-13 04:11:25 +04:00
constants.h Merge github.com:vysheng/tg 2014-03-21 01:03:42 +04:00
gen_constants_h.awk Added full support for layer 10 2013-11-15 14:37:14 +04:00
include.h Added GPL-headers to source files 2013-10-23 18:26:17 +04:00
LICENSE Added GPL license text 2013-10-23 18:53:22 +04:00
LICENSE.h Added some fixes required by GPL 2013-10-25 13:28:29 +04:00
loop.c Use correct DC number for our updated application configuration 2014-10-03 18:21:20 +02:00
loop.h write secret chat file into user-specific directory and fix config path creation 2014-09-06 01:04:57 +02:00
Makefile Add makefile 2014-10-02 14:17:36 +02:00
msglog.c Improve logging system 2014-10-03 14:23:15 +02:00
msglog.h Improve logging system 2014-10-03 14:23:15 +02:00
mtproto-client.c Improve logging system 2014-10-03 14:23:15 +02:00
mtproto-client.h Improve logging system 2014-10-03 14:23:15 +02:00
mtproto-common.c Improve logging system 2014-10-03 14:23:15 +02:00
net.c Add xCode project files for an Adium telegram plugin 2014-10-04 20:32:59 +02:00
net.h Use correct DC number for our updated application configuration 2014-10-03 18:21:20 +02:00
no-preview.h Forgot GPL header. 2013-11-05 03:55:41 +04:00
queries.c Add form for phone registratrion 2014-10-03 17:34:10 +02:00
queries.h Support downloads from foreign DCs 2014-10-02 12:29:02 +02:00
README.md Fix errors in README 2014-10-04 12:19:43 +02:00
structures.c Improve logging system 2014-10-03 14:23:15 +02:00
structures.h Free memory and close connections on disconnect 2014-09-01 21:57:35 +02:00
telegram.c Use correct DC number for our updated application configuration 2014-10-03 18:21:20 +02:00
telegram.h Use correct DC number for our updated application configuration 2014-10-03 18:21:20 +02:00
tg-server.pub Enhance naming to show that the pubkey is the server's. 2014-03-11 15:10:19 +01:00
tools.c Improve logging system 2014-10-03 14:23:15 +02:00
tools.h Refactor - Intermediate Commit 3 2014-08-06 19:45:46 +02:00
tree.h Added partial lua support 2014-01-12 04:43:29 +04:00

Telegram-Purple

Telegram-purple is a Libpurple plugin that adds support for the Telegram messenger. Its still in an early (pre-alpha) development stage, but already provides basic chat functionality and group chats.

This plugin is based on Telegram-cli, a full-featured terminal-based client for Telegram created by Vysheng.

Version 0.2.0

Warning, this version is mainly for development and testing and NOT for productive use.Even though it already provides basic features, you should still expect bugs and crashes when running it.

When encountering a crash or some other bugs, please report it to us, preferably together with a backtrace of the crashed application [https://developer.pidgin.im/wiki/GetABacktrace]

Already Implemented:

- Chats/Group-Chats
    * Send/receive messages
    * Discover buddies/chats
    * Discover buddy state and info
- Profile Pictures
    * Download and use profile pictures

TODO:

The following features are currently planned and will probably be added in the future:

- Encrypted chats
- Picture, audio and video messages
- File transfers
- Geo-locations
- Multiple accounts on one client
- Respect libpurple proxy settings (implemented but untested)
- Adium Plugin

Platform Support

We only provide an installation guide for Linux right now, even though it should be possible to compile this plugin on other platforms. If someone manages to create a working Windows, BSD or OSX build, please let us know.

Installation Instructions

Unfortunately there are no packages right now, so you need to compile it yourself:

1. Get this repository

    git clone https://github.com/majn/telegram-purple

2. Fetch all needed dependencies

This plugin depends on a working libpurple client (like Pidgin or Finch) and the following packages:

    - glib-2.0
    - libssl
    - libpurple
    - libzlib

Fedora

On Fedora you can install all dependencies with:

    sudo yum install gcc openssl-devel glib2-devel libpurple-devel

Debian

On Debian-based systems you can use:

    sudo apt-get install libssl-dev libglib2.0-dev libpurple-dev

NOTE: Ubuntu is currently not working, since libpurple doesn't seem to find libssl when loading the plugin. It will compile, but Pidgin won't be able to load it.

OpenSUSE

    sudo zypper install gcc glib glib-devel libpurple libpurple-devel zlib-devel openssl libopenssl-devel

3. Compile and install

    make
    sudo make install

Usage

After succesfully completing all steps mentioned in the installation instructions, you should restart Pidgin to ensure that the plugin is loaded. When everything went well, Telegram should show up in the account manager:

Create a new Telegram account

The username is your current phone number, including your full country prefix instead of a leading '0'. For Germany, this would be '+49' for example. Telegram will verify your phone number by sending you a verification code via sms. You will be prompted for this code, once that happens.

Provide a phone number

Now you should be able to see all your contacts and chats in your buddy list and send/receive messages.

Unicode Emojis for Pidgin

The Telegram phone applications for iOS and Android make use of standardized Unicode smileys (called Emojis). Pidgin does not display those smileys natively, but you can install a custom smiley theme like (https://github.com/stv0g/unicode-emoji) or (https://github.com/VxJasonxV/emoji-for-pidgin) and activate it under Settings > Themes > Smiley Theme.