tdesktop/README.md

# [Telegram Desktop][telegram_desktop] – Official Messenger

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.

[![Version](https://badge.fury.io/gh/telegramdesktop%2Ftdesktop.svg)](https://github.com/telegramdesktop/tdesktop/releases)
[![Build Status](https://github.com/telegramdesktop/tdesktop/workflows/Windows./badge.svg)](https://github.com/telegramdesktop/tdesktop/actions)
[![Build Status](https://github.com/telegramdesktop/tdesktop/workflows/MacOS./badge.svg)](https://github.com/telegramdesktop/tdesktop/actions)
[![Build Status](https://github.com/telegramdesktop/tdesktop/workflows/Linux./badge.svg)](https://github.com/telegramdesktop/tdesktop/actions)

[![Preview of Telegram Desktop][preview_image]][preview_image_url]

The source code is published under GPLv3 with OpenSSL exception, the license is available [here][license].

## Supported systems

The latest version is available for

* [Windows 7 and above](https://telegram.org/dl/desktop/win) ([portable](https://telegram.org/dl/desktop/win_portable))
* [macOS 10.12 and above](https://telegram.org/dl/desktop/mac)
* [OS X 10.10 and 10.11](https://telegram.org/dl/desktop/osx)
* [Linux static build for 64 bit](https://telegram.org/dl/desktop/linux) ([32 bit](https://telegram.org/dl/desktop/linux32))
* [Snap](https://snapcraft.io/telegram-desktop)
* [Flatpak](https://flathub.org/apps/details/org.telegram.desktop)

## Old system versions

Version **1.8.15** was the last that supports older systems

* [Windows XP and Vista](https://updates.tdesktop.com/tsetup/tsetup.1.8.15.exe) ([portable](https://updates.tdesktop.com/tsetup/tportable.1.8.15.zip))
* [OS X 10.8 and 10.9](https://updates.tdesktop.com/tmac/tsetup.1.8.15.dmg)
* [OS X 10.6 and 10.7](https://updates.tdesktop.com/tmac32/tsetup32.1.8.15.dmg)

## Third-party

* Qt 5.12.8, 5.6.2 and 5.3.2 slightly patched ([LGPL](http://doc.qt.io/qt-5/lgpl.html))
* OpenSSL 1.1.1 and 1.0.1 ([OpenSSL License](https://www.openssl.org/source/license.html))
* WebRTC ([New BSD License](https://github.com/desktop-app/tg_owt/blob/master/src/LICENSE))
* zlib 1.2.11 ([zlib License](http://www.zlib.net/zlib_license.html))
* LZMA SDK 9.20 ([public domain](http://www.7-zip.org/sdk.html))
* liblzma ([public domain](http://tukaani.org/xz/))
* 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))
* 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))
* OpenAL Soft ([LGPL](https://github.com/kcat/openal-soft/blob/master/COPYING))
* Opus codec ([BSD License](http://www.opus-codec.org/license/))
* FFmpeg ([LGPL](https://www.ffmpeg.org/legal.html))
* Guideline Support Library ([MIT License](https://github.com/Microsoft/GSL/blob/master/LICENSE))
* Range-v3 ([Boost License](https://github.com/ericniebler/range-v3/blob/master/LICENSE.txt))
* Open Sans font ([Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html))
* Vazir font ([License](https://github.com/rastikerdar/vazir-font/blob/master/LICENSE))
* Emoji alpha codes ([MIT License](https://github.com/emojione/emojione/blob/master/extras/alpha-codes/LICENSE.md))
* Catch test framework ([Boost License](https://github.com/philsquared/Catch/blob/master/LICENSE.txt))
* xxHash ([BSD License](https://github.com/Cyan4973/xxHash/blob/dev/LICENSE))
* QR Code generator ([MIT License](https://github.com/nayuki/QR-Code-generator#license))
* CMake ([New BSD License](https://github.com/Kitware/CMake/blob/master/Copyright.txt))
* Hunspell ([GPL](https://github.com/hunspell/hunspell/blob/master/COPYING))

## Build instructions

* [Visual Studio 2019][msvc]
* [Xcode 11][xcode]
* [CMake on GNU/Linux][cmake]

[//]: # (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
[msvc]: docs/building-msvc.md
[xcode]: docs/building-xcode.md
[xcode_old]: docs/building-xcode-old.md
[cmake]: docs/building-cmake.md
[preview_image]: https://github.com/telegramdesktop/tdesktop/blob/dev/docs/assets/preview.png "Preview of Telegram Desktop"
[preview_image_url]: https://raw.githubusercontent.com/telegramdesktop/tdesktop/dev/docs/assets/preview.png
-												Style updates
* List for "Projects in Telegram solution"

											
										
										
											2015-09-06 16:17:03 +00:00
+								# [Telegram Desktop][telegram_desktop] – Official Messenger
-												Initial commit

											
										
										
											2014-05-02 12:36:31 +00:00
-												Style updates
* List for "Projects in Telegram solution"

											
										
										
											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.
-												initial commit for 0.4.18 version of Telegram Desktop

											
										
										
											2014-05-30 08:53:19 +00:00
-												Update version badge
											
										
										
											2017-02-01 11:24:59 +00:00
+								[![Version](https://badge.fury.io/gh/telegramdesktop%2Ftdesktop.svg)](https://github.com/telegramdesktop/tdesktop/releases)
-												Added Github CI for Windows and MacOS. Added new build status badges.

											
										
										
											2019-09-06 05:24:37 +00:00
+								[![Build Status](https://github.com/telegramdesktop/tdesktop/workflows/Windows./badge.svg)](https://github.com/telegramdesktop/tdesktop/actions)
 								[![Build Status](https://github.com/telegramdesktop/tdesktop/workflows/MacOS./badge.svg)](https://github.com/telegramdesktop/tdesktop/actions)
-												Added Github CI for Linux. Added new build status badge.

											
										
										
											2020-01-24 13:35:42 +00:00
+								[![Build Status](https://github.com/telegramdesktop/tdesktop/workflows/Linux./badge.svg)](https://github.com/telegramdesktop/tdesktop/actions)
-												Add build status badge to readme

Signed-off-by: Christoph Auer <auer.chrisi@gmx.net>

											
										
										
											2016-03-18 20:06:16 +00:00
-												Link to image

											
										
										
											2017-04-04 12:50:01 +00:00
+								[![Preview of Telegram Desktop][preview_image]][preview_image_url]
-												Add preview image to readme

											
										
										
											2017-04-04 12:45:42 +00:00
-												license openssl exception added

											
										
										
											2015-10-03 11:34:56 +00:00
+								The source code is published under GPLv3 with OpenSSL exception, the license is available [here][license].
-												License link added to README
											
										
										
											2014-05-30 10:09:53 +00:00
-												Updating README.md
Fixed style and small typos

											
										
										
											2015-09-04 14:26:34 +00:00
+								## Supported systems
-												initial commit for 0.4.18 version of Telegram Desktop

											
										
										
											2014-05-30 08:53:19 +00:00
-												Update supported systems information.

											
										
										
											2020-05-08 08:25:48 +00:00
+								The latest version is available for
 								* [Windows 7 and above](https://telegram.org/dl/desktop/win) ([portable](https://telegram.org/dl/desktop/win_portable))
 								* [macOS 10.12 and above](https://telegram.org/dl/desktop/mac)
 								* [OS X 10.10 and 10.11](https://telegram.org/dl/desktop/osx)
 								* [Linux static build for 64 bit](https://telegram.org/dl/desktop/linux) ([32 bit](https://telegram.org/dl/desktop/linux32))
 								* [Snap](https://snapcraft.io/telegram-desktop)
 								* [Flatpak](https://flathub.org/apps/details/org.telegram.desktop)
 								## Old system versions
 								Version **1.8.15** was the last that supports older systems
 								* [Windows XP and Vista](https://updates.tdesktop.com/tsetup/tsetup.1.8.15.exe) ([portable](https://updates.tdesktop.com/tsetup/tportable.1.8.15.zip))
 								* [OS X 10.8 and 10.9](https://updates.tdesktop.com/tmac/tsetup.1.8.15.dmg)
 								* [OS X 10.6 and 10.7](https://updates.tdesktop.com/tmac32/tsetup32.1.8.15.dmg)
-												initial commit for 0.4.18 version of Telegram Desktop

											
										
										
											2014-05-30 08:53:19 +00:00
-												Alpha version 0.10.2: first GYP/Ninja build, some bug and crash fixes.

Counting round radius dynamically to work fine with all font sizes.
Added GYP and Ninja to Third-party section. Fix of build script.

											
										
										
											2016-08-14 19:56:26 +00:00
+								## Third-party
-												app font changed to open sans

											
										
										
											2014-06-17 05:37:53 +00:00
-												Update supported systems information.

											
										
										
											2020-05-08 08:25:48 +00:00
+								* Qt 5.12.8, 5.6.2 and 5.3.2 slightly patched ([LGPL](http://doc.qt.io/qt-5/lgpl.html))
 								* OpenSSL 1.1.1 and 1.0.1 ([OpenSSL License](https://www.openssl.org/source/license.html))
-												Remove mapbox::variant dependency.

											
										
										
											2020-08-31 09:56:28 +00:00
+								* WebRTC ([New BSD License](https://github.com/desktop-app/tg_owt/blob/master/src/LICENSE))
-												Updated Third-party list in README.md.

											
										
										
											2019-12-18 00:33:03 +00:00
+								* zlib 1.2.11 ([zlib License](http://www.zlib.net/zlib_license.html))
-												app font changed to open sans

											
										
										
											2014-06-17 05:37:53 +00:00
+								* LZMA SDK 9.20 ([public domain](http://www.7-zip.org/sdk.html))
-												build instructions done for os x version

											
										
										
											2014-06-25 20:15:34 +00:00
+								* liblzma ([public domain](http://tukaani.org/xz/))
-												langs updated, build scripts updated

											
										
										
											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))
-												Add emoji autocomplete data and algorithm.

											
										
										
											2017-07-19 18:37:49 +00:00
+								* GYP ([BSD License](https://github.com/bnoordhuis/gyp/blob/master/LICENSE))
-												Alpha version 0.10.2: first GYP/Ninja build, some bug and crash fixes.

Counting round radius dynamically to work fine with all font sizes.
Added GYP and Ninja to Third-party section. Fix of build script.

											
										
										
											2016-08-14 19:56:26 +00:00
+								* Ninja ([Apache License 2.0](https://github.com/ninja-build/ninja/blob/master/COPYING))
-												OpenAL soft license link update (#5379)


											
										
										
											2018-11-12 19:42:37 +00:00
+								* OpenAL Soft ([LGPL](https://github.com/kcat/openal-soft/blob/master/COPYING))
-												Add emoji autocomplete data and algorithm.

											
										
										
											2017-07-19 18:37:49 +00:00
+								* Opus codec ([BSD License](http://www.opus-codec.org/license/))
-												instructions for building ffmpeg added

											
										
										
											2015-06-01 12:44:10 +00:00
+								* FFmpeg ([LGPL](https://www.ffmpeg.org/legal.html))
-												Added Guideline Support Library as a dependency.

See https://github.com/Microsoft/GSL for information.

											
										
										
											2017-03-04 08:59:10 +00:00
+								* Guideline Support Library ([MIT License](https://github.com/Microsoft/GSL/blob/master/LICENSE))
-												Add range-v3 library.

											
										
										
											2017-11-19 14:37:07 +00:00
+								* Range-v3 ([Boost License](https://github.com/ericniebler/range-v3/blob/master/LICENSE.txt))
-												license openssl exception added

											
										
										
											2015-10-03 11:34:56 +00:00
+								* Open Sans font ([Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html))
-												Add Vazir font as a fallback for Farsi.

											
										
										
											2020-05-08 09:38:15 +00:00
+								* Vazir font ([License](https://github.com/rastikerdar/vazir-font/blob/master/LICENSE))
-												Add emoji autocomplete data and algorithm.

											
										
										
											2017-07-19 18:37:49 +00:00
+								* Emoji alpha codes ([MIT License](https://github.com/emojione/emojione/blob/master/extras/alpha-codes/LICENSE.md))
-												Add Catch unittest framework and some tests.

											
										
										
											2017-08-30 17:36:12 +00:00
+								* Catch test framework ([Boost License](https://github.com/philsquared/Catch/blob/master/LICENSE.txt))
-												Add xxHash library for checksums.

											
										
										
											2018-07-30 18:30:26 +00:00
+								* xxHash ([BSD License](https://github.com/Cyan4973/xxHash/blob/dev/LICENSE))
-												Fix build on Windows.

											
										
										
											2019-12-06 08:39:13 +00:00
+								* QR Code generator ([MIT License](https://github.com/nayuki/QR-Code-generator#license))
-												Updated Third-party list in README.md.

											
										
										
											2019-12-18 00:33:03 +00:00
+								* CMake ([New BSD License](https://github.com/Kitware/CMake/blob/master/Copyright.txt))
-												Added Hunspell license link to README.md.

											
										
										
											2020-03-14 07:37:13 +00:00
+								* Hunspell ([GPL](https://github.com/hunspell/hunspell/blob/master/COPYING))
-												initial commit for 0.4.18 version of Telegram Desktop

											
										
										
											2014-05-30 08:53:19 +00:00
-												Updating README.md
Fixed style and small typos

											
										
										
											2015-09-04 14:26:34 +00:00
+								## Build instructions
-												initial commit for 0.4.18 version of Telegram Desktop

											
										
										
											2014-05-30 08:53:19 +00:00
-												Closed alpha version 1.6.3.6: Update to VS 2019.

											
										
										
											2019-04-03 18:51:14 +00:00
+								* [Visual Studio 2019][msvc]
-												Updated docs.

 - Removed libenchant-dev.
 - Removed installing OpenSSL shared docs for Linux.
 - Updated xz and libiconv for Xcode.

											
										
										
											2020-02-25 13:56:11 +00:00
+								* [Xcode 11][xcode]
 								* [CMake on GNU/Linux][cmake]
-												initial commit for 0.4.18 version of Telegram Desktop

											
										
										
											2014-05-30 08:53:19 +00:00
-												Updating README.md
Fixed style and small typos

											
										
										
											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
-												Rename doc to docs

											
										
										
											2017-04-04 12:40:49 +00:00
+								[msvc]: docs/building-msvc.md
 								[xcode]: docs/building-xcode.md
 								[xcode_old]: docs/building-xcode-old.md
 								[cmake]: docs/building-cmake.md
-												Add preview image to readme

											
										
										
											2017-04-04 12:45:42 +00:00
+								[preview_image]: https://github.com/telegramdesktop/tdesktop/blob/dev/docs/assets/preview.png "Preview of Telegram Desktop"
-												Link to image

											
										
										
											2017-04-04 12:50:01 +00:00
+								[preview_image_url]: https://raw.githubusercontent.com/telegramdesktop/tdesktop/dev/docs/assets/preview.png