2015-09-06 16:17:03 +00:00
# [Telegram Desktop][telegram_desktop] – Official Messenger
2014-05-02 12:36:31 +00:00
2015-09-06 16:17:03 +00:00
This is the complete source code and the build instructions for the alpha version of the official desktop client for the [Telegram][telegram] messenger, based on the [Telegram API][telegram_api] and the [MTProto][telegram_proto] secure protocol.
2014-05-30 08:53:19 +00:00
2016-03-18 20:06:16 +00:00
[![Build Status ](https://travis-ci.org/telegramdesktop/tdesktop.svg?branch=master )](https://travis-ci.org/telegramdesktop/tdesktop)
2015-10-03 11:34:56 +00:00
The source code is published under GPLv3 with OpenSSL exception, the license is available [here][license].
2014-05-30 10:09:53 +00:00
2015-09-04 14:26:34 +00:00
## Supported systems
2014-05-30 08:53:19 +00:00
2015-08-13 15:09:04 +00:00
* Windows XP - Windows 10 (**not** RT)
2016-03-25 16:43:14 +00:00
* Mac OS X 10.8 - Mac OS X 10.11
2015-08-01 12:56:10 +00:00
* Mac OS X 10.6 - Mac OS X 10.7 (separate build)
2016-05-19 12:03:51 +00:00
* Ubuntu 12.04 - Ubuntu 16.04
2015-06-11 09:34:35 +00:00
* Fedora 22
2014-05-30 08:53:19 +00:00
2016-08-14 19:56:26 +00:00
## Third-party
2014-06-17 05:37:53 +00:00
2016-10-17 21:33:24 +00:00
* Qt 5.3.2 and 5.6.2, slightly patched ([LGPL](http://doc.qt.io/qt-5/lgpl.html))
2014-06-17 05:37:53 +00:00
* OpenSSL 1.0.1g ([OpenSSL License](https://www.openssl.org/source/license.html))
* zlib 1.2.8 ([zlib License](http://www.zlib.net/zlib_license.html))
* libexif 0.6.20 ([LGPL](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html))
* LZMA SDK 9.20 ([public domain](http://www.7-zip.org/sdk.html))
2014-06-25 20:15:34 +00:00
* liblzma ([public domain](http://tukaani.org/xz/))
2016-02-04 12:44:39 +00:00
* Google Breakpad ([License](https://chromium.googlesource.com/breakpad/breakpad/+/master/LICENSE))
* Google Crashpad ([Apache License 2.0](https://chromium.googlesource.com/crashpad/crashpad/+/master/LICENSE))
2016-08-14 19:56:26 +00:00
* GYP ([BSD license](https://github.com/bnoordhuis/gyp/blob/master/LICENSE))
* Ninja ([Apache License 2.0](https://github.com/ninja-build/ninja/blob/master/COPYING))
2014-09-04 07:33:44 +00:00
* OpenAL Soft ([LGPL](http://kcat.strangesoft.net/openal.html))
2015-06-01 12:44:10 +00:00
* Opus codec ([BSD license](http://www.opus-codec.org/license/))
* FFmpeg ([LGPL](https://www.ffmpeg.org/legal.html))
2015-10-03 11:34:56 +00:00
* Open Sans font ([Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html))
2014-05-30 08:53:19 +00:00
2015-09-04 14:26:34 +00:00
## Build instructions
2014-05-30 08:53:19 +00:00
2015-10-19 21:24:39 +00:00
* [Visual Studio 2015][msvc]
2016-10-17 14:57:14 +00:00
* [Xcode 8][xcode]
2016-09-12 11:45:41 +00:00
* [GYP/CMake on GNU/Linux][cmake]
2014-05-30 08:53:19 +00:00
2015-09-04 14:26:34 +00:00
## Projects in Telegram solution
2015-08-01 12:56:10 +00:00
2015-09-06 16:17:03 +00:00
* ### Telegram
2014-07-15 06:03:11 +00:00
2015-09-06 16:17:03 +00:00
[Telegram Desktop][telegram_desktop] messenger
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
* ### Updater
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
A little app, that is launched by Telegram when update is ready, replaces all files and launches it back.
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
* ### Packer
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
Compiles given files to single update file, compresses it with lzma and signs with a private key. It is not built in **Debug** and **Release** configurations of Telegram solution, because private key is inaccessible.
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
* ### MetaEmoji
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
Creates four sprites and text2emoji replace code
* SourceFiles/art/emoji.png
* SourceFiles/art/emoji_125x.png
* SourceFiles/art/emoji_150x.png
* SourceFiles/art/emoji_200x.png
* SourceFiles/art/emoji_250x.png
2016-08-02 12:33:17 +00:00
* SourceFiles/ui/emoji_config.cpp
2014-05-30 08:53:19 +00:00
2016-04-22 07:25:14 +00:00
* ### codegen_style
* ### codegen_numbers
Helper code generating console utilities.
2014-05-30 08:53:19 +00:00
2015-09-06 16:17:03 +00:00
* ### MetaLang
2014-05-30 08:53:19 +00:00
2016-03-24 15:07:13 +00:00
Creates from languagepack file `Resources/lang.strings` language constants code and language file parse code:
2015-09-06 16:17:03 +00:00
* GeneratedFiles/lang.h
* GeneratedFiles/lang.cpp
2015-09-04 14:26:34 +00:00
[//]: # (LINKS)
[telegram]: https://telegram.org
[telegram_desktop]: https://desktop.telegram.org
[telegram_api]: https://core.telegram.org
[telegram_proto]: https://core.telegram.org/mtproto
[license]: LICENSE
2016-02-19 00:23:43 +00:00
[msvc]: doc/building-msvc.md
[xcode]: doc/building-xcode.md
[xcode_old]: doc/building-xcode-old.md
2016-09-12 11:45:41 +00:00
[cmake]: doc/building-cmake.md