Version 1.2.0.

- Radically improved navigation. New side panel on the right
with quick access to shared media and group members.
- Saved Messages. Bookmark messages by forwarding them to "Saved
Messages". Access them from the Chats list or from the side menu.
- Pinned Messages. If you are a channel admin, pin messages to
focus your subscribers' attention on important announcements.
- Easily recognize messages from group admins by the new admin badge.
- Also supported clearing history in supergroups and
added a host of minor improvements.

.appveyor/install.bat

@@ -0,0 +1,92 @@
+@echo off
+
+IF "%BUILD_DIR%"=="" SET BUILD_DIR=C:\TBuild
+SET LIB_DIR=%BUILD_DIR%\Libraries
+SET SRC_DIR=%BUILD_DIR%\tdesktop
+SET QT_VERSION=5_6_2
+
+call:configureBuild
+call:getDependencies
+call:setupGYP
+cd %SRC_DIR%
+
+echo Finished!
+
+GOTO:EOF
+
+:: FUNCTIONS
+:logInfo
+    echo [INFO] %~1
+GOTO:EOF
+
+:logError
+    echo [ERROR] %~1
+GOTO:EOF
+
+:getDependencies
+    call:logInfo "Clone dependencies repository"
+    git clone -q --depth 1 --branch=master https://github.com/telegramdesktop/dependencies_windows.git %LIB_DIR%
+    cd %LIB_DIR%
+    git clone https://github.com/Microsoft/Range-V3-VS2015 range-v3
+    if exist prepare.bat (
+        call prepare.bat
+    ) else (
+        call:logError "Error cloning dependencies, trying again"
+        rmdir %LIB_DIR% /S /Q
+        call:getDependencies
+    )
+GOTO:EOF
+
+:setupGYP
+    call:logInfo "Setup GYP/Ninja and generate VS solution"
+    cd %LIB_DIR%
+    git clone https://chromium.googlesource.com/external/gyp
+    cd gyp
+    git checkout a478c1ab51
+    SET PATH=%PATH%;%BUILD_DIR%\Libraries\gyp;%BUILD_DIR%\Libraries\ninja;
+    cd %SRC_DIR%
+    git submodule init
+    git submodule update
+    cd %SRC_DIR%\Telegram
+    call gyp\refresh.bat
+GOTO:EOF
+
+:configureBuild
+    call:logInfo "Configuring build"
+    call:logInfo "Build version: %BUILD_VERSION%"
+    set TDESKTOP_BUILD_DEFINES=
+
+    echo %BUILD_VERSION% | findstr /C:"disable_autoupdate">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_AUTOUPDATE
+    )
+
+    echo %BUILD_VERSION% | findstr /C:"disable_register_custom_scheme">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_REGISTER_CUSTOM_SCHEME
+    )
+
+    echo %BUILD_VERSION% | findstr /C:"disable_crash_reports">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_CRASH_REPORTS
+    )
+
+    echo %BUILD_VERSION% | findstr /C:"disable_network_proxy">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_NETWORK_PROXY
+    )
+
+    echo %BUILD_VERSION% | findstr /C:"disable_desktop_file_generation">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_DESKTOP_FILE_GENERATION
+    )
+
+    echo %BUILD_VERSION% | findstr /C:"disable_unity_integration">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_UNITY_INTEGRATION
+    )
+
+    echo %BUILD_VERSION% | findstr /C:"disable_gtk_integration">nul && (
+        set TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES%,TDESKTOP_DISABLE_GTK_INTEGRATION
+    )
+
+    if not "%TDESKTOP_BUILD_DEFINES%" == "" (
+        set "TDESKTOP_BUILD_DEFINES=%TDESKTOP_BUILD_DEFINES:~1%"
+    )
+
+    call:logInfo "Build Defines: %TDESKTOP_BUILD_DEFINES%"
+GOTO:EOF

.gitattributes

@@ -3,3 +3,4 @@
 
 # Ensure diffs have LF endings
 *.diff text eol=lf
+*.bat text eol=crlf

.github/CONTRIBUTING.md

@@ -5,8 +5,6 @@ This document describes how you can contribute to Telegram Desktop. Please read
 **Table of Contents**
 
 * [What contributions are accepted](#what-contributions-are-accepted)
-* [Sign your work](#sign-your-work)
-  * [Change commit message of a pushed commit](#change-commit-message-of-a-pushed-commit)
 * [Build instructions](#build-instructions)
 * [Pull upstream changes into your fork regularly](#pull-upstream-changes-into-your-fork-regularly)
 * [How to get your pull request accepted](#how-to-get-your-pull-request-accepted)
@@ -28,49 +26,6 @@ Unfortunately we **do not merge** any pull requests that have new feature implem
 
 Telegram Desktop is not a standalone application but a part of [Telegram project][telegram], so all the decisions about the features, languages, user experience, user interface and the design are made inside Telegram team, often according to some roadmap which is not public.
 
-## Sign your work
-
-For contributions to be accepted they should be granted into the public domain. This will solve the issue if Telegram team needs to use full Telegram Desktop source code with some different license.
-
-The sign-off is a simple line at the end of the explanation for the patch. Your signature certifies that you wrote the patch and you have the right to put it in the public domain. The rules are pretty simple: if you can certify the below:
-
-```
-Telegram Desktop Developer Certificate of Origin
-
-By making a contribution to this project, I certify that:
-
-(a) The contribution was created in whole by me or is based upon
-    previous work that, to the best of my knowledge, is in the
-    public domain and I have the right to put it in the public domain.
-
-(d) I understand and agree that this project and the contribution are
-    public and that a record of the contribution (including all
-    metadata and personal information I submit with it, including my
-    sign-off) is maintained indefinitely and may be redistributed.
-
-(e) I am granting this work into the public domain.
-```
-
-Then you just add a line to every **git commit message** that states:
-
-    Signed-off-by: Random J Developer <random@developer.example.org> (github: rndjdev_github)
-
-Replacing Random Developer’s details with your name, email address and GitHub username.
-
-### Change commit message of a pushed commit
-
-If you already pushed a commit and forgot to add the signature to the commit message, follow these steps to change the message of the commit:
-
-1. Open `Git Bash` (or `Git Shell`)
-2. Enter following command to change the commit message of the most recent commit: `git commit --amend`
-3. Press <kbd>i</kbd> to get into Insert-mode
-4. Change the commit message (and add the [signature](#sign-your-work) at the and)
-5. After editing the message, press <kbd>ESC</kbd> to get out of the Insert-mode
-6. Write `:wq` and press <kbd>Enter</kbd> to save the new message or write `:q!` to discard your changes
-7. Enter `git push --force` to push the commit with the new commit message to the remote repository
-
-For more info, see [GitHub Help][help_change_commit_message].
-
 ## Build instructions
 
 See the [README.md][build_instructions] for details on the various build
@@ -118,7 +73,7 @@ If you already have multiple commits, you can add the commits together (squash t
 1. Open `Git Bash` (or `Git Shell`)
 2. Enter following command to squash the recent {N} commits: `git reset --soft HEAD~{N} && git commit` (replace `{N}` with the number of commits you want to squash)
 3. Press <kbd>i</kbd> to get into Insert-mode
-4. Enter the commit message of the new commit (and add the [signature](#sign-your-work) at the and)
+4. Enter the commit message of the new commit
 5. After adding the message, press <kbd>ESC</kbd> to get out of the Insert-mode
 6. Write `:wq` and press <kbd>Enter</kbd> to save the new message or write `:q!` to discard your changes
 7. Enter `git push --force` to push the new commit to the remote repository
@@ -144,9 +99,11 @@ Before you submit a pull request, please test your changes. Verify that Telegram
 
 ### Write a good commit message
 
-Explain why you make the changes. [More infos about a good commit message.][commit_message]
-Maybe reference also the related issue in your commit message.
-Don't forget to [sign your patch](#sign-your-work) to put it in the public domain.
+* Explain why you make the changes. [More infos about a good commit message.][commit_message]
+
+* If you fix an issue with your commit, please close the issue by [adding one of the keywords and the issue number][closing-issues-via-commit-messages] to your commit message.
+
+  For example: `Fix #545`
 
 [//]: # (LINKS)
 [telegram]: https://telegram.org/
@@ -154,4 +111,5 @@ Don't forget to [sign your patch](#sign-your-work) to put it in the public domai
 [help_change_commit_message]: https://help.github.com/articles/changing-a-commit-message/
 [commit_message]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
 [pr]: https://github.com/telegramdesktop/tdesktop/compare
-[build_instructions]: https://github.com/telegramdesktop/tdesktop/blob/master/README.md#build-instructions
+[build_instructions]: https://github.com/telegramdesktop/tdesktop/blob/master/README.md#build-instructions
+[closing-issues-via-commit-messages]: https://help.github.com/articles/closing-issues-via-commit-messages/

.github/ISSUE_TEMPLATE.md

@@ -19,8 +19,11 @@ Tell us what happens instead
 
 **Version of Telegram Desktop:**
 
-### Logs
+**Used theme**:
+
+<details><summary><b>Logs</b>:</summary>
 Insert logs here (if necessary)
 
-You can type `debugmode` in settings and then see ~/.TelegramDesktop/DebugLogs/log_...txt for log files.
-Type `debugmode` in settings again to disable logs.
+<!-- You can type `debugmode` in settings and then see ~/.TelegramDesktop/DebugLogs/log_...txt for log files.
+Type `debugmode` in settings again to disable logs. -->
+</details>

.gitignore

@@ -2,6 +2,7 @@
 /Debug/
 /Release/
 /Deploy/
+/ThirdParty/
 /Telegram/build/target
 /Telegram/GeneratedFiles/
 /Telegram/SourceFiles/art/grid.png
@@ -16,6 +17,11 @@
 /Telegram/Resources/art/grid_200x.png
 /Telegram/Resources/art/sprite_125x.png
 /Telegram/Resources/art/sprite_150x.png
+/Telegram/Debug/
+/Telegram/Release/
+/Telegram/tests/
+/Telegram/gyp/tests/*.test
+/Telegram/out/
 /Telegram/*.user
 *.vcxproj*
 *.sln
@@ -28,6 +34,7 @@
 *.xcodeproj
 /Win32/
 ipch/
+.vs/
 
 /Telegram/log.txt
 /Telegram/data

.gitmodules

@@ -0,0 +1,12 @@
+[submodule "Telegram/ThirdParty/libtgvoip"]
+	path = Telegram/ThirdParty/libtgvoip
+	url = https://github.com/telegramdesktop/libtgvoip
+[submodule "Telegram/ThirdParty/variant"]
+	path = Telegram/ThirdParty/variant
+	url = https://github.com/mapbox/variant
+[submodule "Telegram/ThirdParty/GSL"]
+	path = Telegram/ThirdParty/GSL
+	url = https://github.com/Microsoft/GSL.git
+[submodule "Telegram/ThirdParty/Catch"]
+	path = Telegram/ThirdParty/Catch
+	url = https://github.com/philsquared/Catch

.travis.yml

@@ -8,9 +8,6 @@ cache:
     - $HOME/travisCacheDir
 
 env:
-  global:
-    # GitHub auth token (GH_AUTH_TOKEN)
-    - secure: "QBbD9VXAx3Mn0vFmHZtm6/sq+twMyR7ilQh7TQm8gBy2TrjhHKDKQ4wRQ5sa2MUFUbzrUOvPlPGq1WuY1mAUt8UE6jZDJNyyDWb6iIlcEmNRsd39XAhYHvJ+uI9JsD+U3OctZ+7Bo4fno0RLv1D5lzh5bpohmjgWxx9TiSZItbsRU+m0XM0Tahx335aXF8NFoVjheGXCOcLAXDt6OmaKPmlrXreuta5nOoRKeOg5vHlt/KNU1pYb8MFvWJc14DKxq3jNqrYlo9vHFv5tVhR1aqvVFWTD/4Z88OSxx3POzyVWdMso0lFov9uxs8qHoqLsGhDMElggyz/jnqZIHpwQMaYIGQ0LLYDv21jGgOuCOWKYlfjDY+tuESXmVPzerTlYBWLZDPrpE8BnXVYo8B/sF4WN6oCuBRjawlqYhqTH+tDDORc9Uc9pamhcuh6OsLMx3PHoyg8joN3t8yUnwhySXyfQ36hqlZ+Y4bBDRZBH/SB/EPmedyLGwdhzQFsUnOBotYeOym7LUdnGraGcj1iTPLdo5TMlBYlAiB12J5mHTNuzUKXh+PBV4REg4Mm2xYX+Pue5Qo1JcOWJteIX4BdPv526DXB3yaNWS1pZgGvYqtBwQlCeOfwOYupS0PksvmV7aX7c4qJSyW3dmEd03cxmebD0b2SbqyPxGFuUajJ7B60="
   matrix:
    - BUILD_VERSION=""
    - BUILD_VERSION="disable_autoupdate"
@@ -19,6 +16,7 @@ env:
    - BUILD_VERSION="disable_network_proxy"
    - BUILD_VERSION="disable_desktop_file_generation"
    - BUILD_VERSION="disable_unity_integration"
+   - BUILD_VERSION="disable_gtk_integration"
 
 matrix:
   fast_finish: true
@@ -35,8 +33,8 @@ addons:
       - dpatch
       - equivs
       - fakeroot
-      - g++-4.9
-      - gcc-4.9
+      - g++-7
+      - gcc-7
       - git
       - gnome-common
       - gobject-introspection
@@ -60,10 +58,8 @@ addons:
       - yasm
 
 before_install:
-  - "export TRAVIS_COMMIT_MSG=\"$(git log --format=%B --no-merges -n 1)\""
-  - .travis/check.sh
-  - export CXX="g++-4.9" CC="gcc-4.9"
-  - sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.9 60 --slave /usr/bin/g++ g++ /usr/bin/g++-4.9
+  - export CXX="g++-7" CC="gcc-7"
+  - sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 60 --slave /usr/bin/g++ g++ /usr/bin/g++-7
   - sudo update-alternatives --config gcc
   - g++ --version
 

.travis/build.sh

@@ -9,33 +9,38 @@ UPSTREAM="$REPO/upstream"
 EXTERNAL="$REPO/external"
 CACHE="$HOME/travisCacheDir"
 
+QT_WAS_BUILT="0"
+
 QT_VERSION=5.6.2
 
 XKB_PATH="$BUILD/libxkbcommon"
-XKB_CACHE_VERSION="2"
+XKB_CACHE_VERSION="3"
 
 QT_PATH="$BUILD/qt"
-QT_CACHE_VERSION="2"
+QT_CACHE_VERSION="3"
 QT_PATCH="$UPSTREAM/Telegram/Patches/qtbase_${QT_VERSION//\./_}.diff"
 
 BREAKPAD_PATH="$BUILD/breakpad"
-BREAKPAD_CACHE_VERSION="2"
+BREAKPAD_CACHE_VERSION="3"
 
 GYP_PATH="$BUILD/gyp"
-GYP_CACHE_VERSION="2"
+GYP_CACHE_VERSION="3"
 GYP_PATCH="$UPSTREAM/Telegram/Patches/gyp.diff"
 
+RANGE_PATH="$BUILD/range-v3"
+RANGE_CACHE_VERSION="3"
+
 VA_PATH="$BUILD/libva"
-VA_CACHE_VERSION="2"
+VA_CACHE_VERSION="3"
 
 VDPAU_PATH="$BUILD/libvdpau"
-VDPAU_CACHE_VERSION="1"
+VDPAU_CACHE_VERSION="3"
 
 FFMPEG_PATH="$BUILD/ffmpeg"
-FFMPEG_CACHE_VERSION="2"
+FFMPEG_CACHE_VERSION="3"
 
 OPENAL_PATH="$BUILD/openal-soft"
-OPENAL_CACHE_VERSION="2"
+OPENAL_CACHE_VERSION="3"
 
 GYP_DEFINES=""
 
@@ -57,6 +62,8 @@ run() {
 build() {
   mkdir -p "$EXTERNAL"
 
+  BUILD_VERSION_DATA=$(echo $BUILD_VERSION | cut -d'-' -f 1)
+
   # libxkbcommon
   getXkbCommon
 
@@ -81,6 +88,17 @@ build() {
   # Patched GYP (supports cmake precompiled headers)
   getGYP
 
+  # Range v3
+  getRange
+
+  # Guideline Support Library
+  getGSL
+
+  if [ "$QT_WAS_BUILT" == "1" ]; then
+    error_msg "Qt was built, please restart the job :("
+    exit 1
+  fi
+
   # Configure the build
   if [[ $BUILD_VERSION == *"disable_autoupdate"* ]]; then
     GYP_DEFINES+=",TDESKTOP_DISABLE_AUTOUPDATE"
@@ -106,6 +124,10 @@ build() {
     GYP_DEFINES+=",TDESKTOP_DISABLE_UNITY_INTEGRATION"
   fi
 
+  if [[ $BUILD_VERSION == *"disable_gtk_integration"* ]]; then
+    GYP_DEFINES+=",TDESKTOP_DISABLE_GTK_INTEGRATION"
+  fi
+
   info_msg "Build defines: ${GYP_DEFINES}"
 
   buildTelegram
@@ -162,6 +184,52 @@ buildXkbCommon() {
   sudo ldconfig
 }
 
+getRange() {
+  travisStartFold "Getting range-v3"
+
+  local RANGE_CACHE="$CACHE/range-v3"
+  local RANGE_CACHE_FILE="$RANGE_CACHE/.cache.txt"
+  local RANGE_CACHE_KEY="${RANGE_CACHE_VERSION}"
+  local RANGE_CACHE_OUTDATED="1"
+
+  if [ ! -d "$RANGE_CACHE" ]; then
+    mkdir -p "$RANGE_CACHE"
+  fi
+
+  ln -sf "$RANGE_CACHE" "$RANGE_PATH"
+
+  if [ -f "$RANGE_CACHE_FILE" ]; then
+    local RANGE_CACHE_KEY_FOUND=`tail -n 1 $RANGE_CACHE_FILE`
+    if [ "$RANGE_CACHE_KEY" == "$RANGE_CACHE_KEY_FOUND" ]; then
+      RANGE_CACHE_OUTDATED="0"
+    else
+      info_msg "Cache key '$RANGE_CACHE_KEY_FOUND' does not match '$RANGE_CACHE_KEY', getting range-v3"
+    fi
+  fi
+  if [ "$RANGE_CACHE_OUTDATED" == "1" ]; then
+    buildRange
+    sudo echo $RANGE_CACHE_KEY > "$RANGE_CACHE_FILE"
+  else
+    info_msg "Using cached range-v3"
+  fi
+}
+
+buildRange() {
+  info_msg "Downloading range-v3"
+
+  if [ -d "$EXTERNAL/range-v3" ]; then
+    rm -rf "$EXTERNAL/range-v3"
+  fi
+  cd $RANGE_PATH
+  rm -rf *
+
+  cd "$EXTERNAL"
+  git clone --depth=1 https://github.com/ericniebler/range-v3
+
+  cd "$EXTERNAL/range-v3"
+  cp -r * "$RANGE_PATH/"
+}
+
 getVa() {
   travisStartFold "Getting libva"
 
@@ -202,7 +270,7 @@ buildVa() {
   rm -rf *
 
   cd "$EXTERNAL"
-  git clone git://anongit.freedesktop.org/git/libva
+  git clone https://github.com/01org/libva
 
   cd "$EXTERNAL/libva"
   ./autogen.sh --prefix=$VA_PATH --enable-static
@@ -303,6 +371,8 @@ buildFFmpeg() {
   git clone https://git.ffmpeg.org/ffmpeg.git
 
   cd "$EXTERNAL/ffmpeg"
+  git checkout release/3.4
+
   ./configure \
       --prefix=$FFMPEG_PATH \
       --disable-debug \
@@ -508,6 +578,7 @@ getCustomQt() {
 }
 
 buildCustomQt() {
+  QT_WAS_BUILT="1"
   info_msg "Downloading and building patched qt"
 
   if [ -d "$EXTERNAL/qt${QT_VERSION}" ]; then
@@ -520,8 +591,7 @@ buildCustomQt() {
   git clone git://code.qt.io/qt/qt5.git qt${QT_VERSION}
 
   cd "$EXTERNAL/qt${QT_VERSION}"
-  git checkout "$(echo ${QT_VERSION} | sed -e s/\..$//)"
-  perl init-repository --module-subset=qtbase,qtimageformats
+  perl init-repository --branch --module-subset=qtbase,qtimageformats
   git checkout v${QT_VERSION}
   cd qtbase && git checkout v${QT_VERSION} && cd ..
   cd qtimageformats && git checkout v${QT_VERSION} && cd ..
@@ -530,6 +600,11 @@ buildCustomQt() {
   git apply "$QT_PATCH"
   cd ..
 
+  cd "$EXTERNAL/qt${QT_VERSION}/qtbase/src/plugins/platforminputcontexts"
+  git clone https://github.com/telegramdesktop/fcitx.git
+  git clone https://github.com/telegramdesktop/hime.git
+  cd ../../../..
+
   ./configure -prefix $QT_PATH -release -opensource -confirm-license -qt-zlib \
               -qt-libpng -qt-libjpeg -qt-freetype -qt-harfbuzz -qt-pcre -qt-xcb \
               -qt-xkbcommon-x11 -no-opengl -no-gtkstyle -static \
@@ -539,6 +614,12 @@ buildCustomQt() {
   sudo make install
 }
 
+getGSL() {
+  cd "$UPSTREAM"
+  git submodule init
+  git submodule update
+}
+
 getGYP() {
   travisStartFold "Getting patched GYP"
 
@@ -583,7 +664,7 @@ buildGYP() {
   git clone https://chromium.googlesource.com/external/gyp
 
   cd "$EXTERNAL/gyp"
-  git checkout 702ac58e4772
+  git checkout 702ac58e47
   git apply "$GYP_PATCH"
   cp -r * "$GYP_PATH/"
 }
@@ -593,19 +674,21 @@ buildTelegram() {
 
   cd "$UPSTREAM/Telegram/gyp"
   "$GYP_PATH/gyp" \
-      -Dtravis_defines=${GYP_DEFINES:1} \
+      -Dbuild_defines=${GYP_DEFINES:1} \
       -Dlinux_path_xkbcommon=$XKB_PATH \
       -Dlinux_path_va=$VA_PATH \
       -Dlinux_path_vdpau=$VDPAU_PATH \
       -Dlinux_path_ffmpeg=$FFMPEG_PATH \
       -Dlinux_path_openal=$OPENAL_PATH \
+      -Dlinux_path_range=$RANGE_PATH \
       -Dlinux_path_qt=$QT_PATH \
       -Dlinux_path_breakpad=$BREAKPAD_PATH \
       -Dlinux_path_libexif_lib=/usr/local/lib \
+      -Dlinux_path_opus_include=/usr/include/opus \
       -Dlinux_lib_ssl=-lssl \
       -Dlinux_lib_crypto=-lcrypto \
       -Dlinux_lib_icu=-licuuc\ -licutu\ -licui18n \
-      --depth=. --generator-output=../.. --format=cmake -Goutput_dir=out \
+      --depth=. --generator-output=.. --format=cmake -Goutput_dir=../out \
       Telegram.gyp
   cd "$UPSTREAM/out/Debug"
 
@@ -617,7 +700,7 @@ buildTelegram() {
 check() {
   local filePath="$UPSTREAM/out/Debug/Telegram"
   if test -f "$filePath"; then
-    success_msg "Build successful done! :)"
+    success_msg "Build successfully done! :)"
 
     local size;
     size=$(stat -c %s "$filePath")

.travis/check.sh

@@ -1,57 +0,0 @@
-#!/bin/bash
-# Checks commit message, ...
-
-run() {
-	checkCommitMessage
-}
-
-checkCommitMessage() {
-	info_msg "Commit message: ${TRAVIS_COMMIT_MSG}";
-	info_msg "Is pull request: ${TRAVIS_PULL_REQUEST}";
-
-	if [[ $TRAVIS_PULL_REQUEST != "false" ]];then
-		if [[  $TRAVIS_COMMIT_MSG != *"Signed-off-by: "* ]];then
-			error_msg "The commit message does not contain the signature!"
-			error_msg "More information: https://github.com/telegramdesktop/tdesktop/blob/master/.github/CONTRIBUTING.md#sign-your-work"
-			addMissingSignatureInfos
-			exit 1
-		else
-			success_msg "Commit message contains signature"
-		fi
-	fi
-}
-
-addMissingSignatureInfos() {
-	if [[ $BUILD_VERSION == "" ]]; then
-		local TEXT="Hi,\n\
-thanks for the pull request!\n\
-\n\
-Please read our [contributing policy](https://github.com/telegramdesktop/tdesktop/blob/master/.github/CONTRIBUTING.md). You'll need to make a pull request with the \\\"Signed-off-by:\\\" signature being the last line of your commit message, like it is described in [sign your work](https://github.com/telegramdesktop/tdesktop/blob/master/.github/CONTRIBUTING.md#sign-your-work) section. That will grant your work into the public domain.\n\
-\n\
-(See [travis build](https://travis-ci.org/telegramdesktop/tdesktop/jobs/${TRAVIS_JOB_ID}))"
-		addCommentToGitHub "${TEXT}"
-		addLabelToGitHub "missing signature"
-		info_msg "Added missing signature info on github"
-	fi
-}
-
-addCommentToGitHub() {
-	local BODY=$1
-	sendGitHubRequest "POST" "{\"body\": \"${BODY}\"}" "repos/${TRAVIS_REPO_SLUG}/issues/${TRAVIS_PULL_REQUEST}/comments"
-}
-
-addLabelToGitHub() {
-	local LABEL=$1
-	sendGitHubRequest "PATCH" "{\"labels\": [\"${LABEL}\"]}" "repos/${TRAVIS_REPO_SLUG}/issues/${TRAVIS_PULL_REQUEST}"
-}
-
-sendGitHubRequest() {
-	local METHOD=$1
-	local BODY=$2
-	local URI=$3
-	curl -H "Authorization: token ${GH_AUTH_TOKEN}" --request "${METHOD}" --data "${BODY}" --silent "https://api.github.com/${URI}" > /dev/null
-}
-
-source ./.travis/common.sh
-
-run

.travis/common.sh

@@ -1,3 +1,4 @@
+#!/usr/bin/env bash
 # set colors
 RCol='\e[0m'    # Text Reset
 
@@ -11,8 +12,6 @@ Pur='\e[0;35m';     BPur='\e[1;35m';    UPur='\e[4;35m';    IPur='\e[0;95m';
 Cya='\e[0;36m';     BCya='\e[1;36m';    UCya='\e[4;36m';    ICya='\e[0;96m';    BICya='\e[1;96m';   On_Cya='\e[46m';    On_ICya='\e[0;106m';
 Whi='\e[0;37m';     BWhi='\e[1;37m';    UWhi='\e[4;37m';    IWhi='\e[0;97m';    BIWhi='\e[1;97m';   On_Whi='\e[47m';    On_IWhi='\e[0;107m';
 
-
-
 start_msg() {
     echo -e "\n${Gre}$*${RCol}"
 }

README.md

@@ -2,8 +2,11 @@
 
 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.
 
-[![GitHub version](https://badge.fury.io/gh/telegramdesktop%2Ftdesktop.svg)](https://badge.fury.io/gh/telegramdesktop%2Ftdesktop)
-[![Build Status](https://travis-ci.org/telegramdesktop/tdesktop.svg?branch=master)](https://travis-ci.org/telegramdesktop/tdesktop)
+[![Version](https://badge.fury.io/gh/telegramdesktop%2Ftdesktop.svg)](https://github.com/telegramdesktop/tdesktop/releases)
+[![Build Status](https://travis-ci.org/telegramdesktop/tdesktop.svg?branch=dev)](https://travis-ci.org/telegramdesktop/tdesktop)
+[![Build status](https://ci.appveyor.com/api/projects/status/uiw2y768iy4i5bu8/branch/dev?svg=true)](https://ci.appveyor.com/project/telegramdesktop/tdesktop)
+
+[![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].
 
@@ -25,61 +28,33 @@ The source code is published under GPLv3 with OpenSSL exception, the license is
 * 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))
+* 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](http://kcat.strangesoft.net/openal.html))
-* Opus codec ([BSD license](http://www.opus-codec.org/license/))
+* 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))
+* Mapbox Variant ([BSD License](https://github.com/mapbox/variant/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))
+* 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))
 
 ## Build instructions
 
-* [Visual Studio 2015][msvc]
-* [Xcode 8][xcode]
+* [Visual Studio 2017][msvc]
+* [Xcode 9][xcode]
 * [GYP/CMake on GNU/Linux][cmake]
 
-## Projects in Telegram solution
-
-* ### Telegram
-
-  [Telegram Desktop][telegram_desktop] messenger
-
-* ### Updater
-
-  A little app, that is launched by Telegram when update is ready, replaces all files and launches it back.
-
-* ### Packer
-
-  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.
-
-* ### MetaEmoji
-
-  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
-  * SourceFiles/ui/emoji_config.cpp
-
-* ### codegen_style
-* ### codegen_numbers
-
-  Helper code generating console utilities.
-
-* ### MetaLang
-
-  Creates from languagepack file `Resources/lang.strings` language constants code and language file parse code:
-  * GeneratedFiles/lang.h
-  * GeneratedFiles/lang.cpp
-
 [//]: # (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]: doc/building-msvc.md
-[xcode]: doc/building-xcode.md
-[xcode_old]: doc/building-xcode-old.md
-[cmake]: doc/building-cmake.md
+[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

Telegram/Patches/breakpad.diff

@@ -1,5 +1,17 @@
+diff --git a/src/build/common.gypi b/src/build/common.gypi
+index 29990c6..53e99d4 100644
+--- a/src/build/common.gypi
++++ b/src/build/common.gypi
+@@ -330,6 +330,7 @@
+           'VCCLCompilerTool': {
+             'WarnAsError': 'true',
+             'Detect64BitPortabilityProblems': 'false',
++            'TreatWChar_tAsBuiltInType': 'false',
+           },
+         },
+       }],
 diff --git a/src/client/mac/Breakpad.xcodeproj/project.pbxproj b/src/client/mac/Breakpad.xcodeproj/project.pbxproj
-index 584ec5d..1c7214f 100644
+index 1a93ce6..1c1d643 100644
 --- a/src/client/mac/Breakpad.xcodeproj/project.pbxproj
 +++ b/src/client/mac/Breakpad.xcodeproj/project.pbxproj
 @@ -35,6 +35,19 @@
@@ -77,7 +89,7 @@ index 584ec5d..1c7214f 100644
  /* End PBXContainerItemProxy section */
  
  /* Begin PBXCopyFilesBuildPhase section */
-@@ -715,7 +703,6 @@
+@@ -714,7 +702,6 @@
  			isa = PBXFrameworksBuildPhase;
  			buildActionMask = 2147483647;
  			files = (
@@ -85,7 +97,7 @@ index 584ec5d..1c7214f 100644
  				8DC2EF570486A6940098B216 /* Cocoa.framework in Frameworks */,
  			);
  			runOnlyForDeploymentPostprocessing = 0;
-@@ -1183,18 +1170,13 @@
+@@ -1181,18 +1168,13 @@
  			isa = PBXNativeTarget;
  			buildConfigurationList = 1DEB91AD08733DA50010E9CD /* Build configuration list for PBXNativeTarget "Breakpad" */;
  			buildPhases = (
@@ -104,7 +116,7 @@ index 584ec5d..1c7214f 100644
  			);
  			name = Breakpad;
  			productInstallPath = "$(HOME)/Library/Frameworks";
-@@ -1401,6 +1383,8 @@
+@@ -1399,6 +1381,8 @@
  /* Begin PBXProject section */
  		0867D690FE84028FC02AAC07 /* Project object */ = {
  			isa = PBXProject;
@@ -113,7 +125,7 @@ index 584ec5d..1c7214f 100644
  			buildConfigurationList = 1DEB91B108733DA50010E9CD /* Build configuration list for PBXProject "Breakpad" */;
  			compatibilityVersion = "Xcode 3.1";
  			developmentRegion = English;
-@@ -1585,16 +1569,6 @@
+@@ -1583,16 +1567,6 @@
  /* End PBXReferenceProxy section */
  
  /* Begin PBXResourcesBuildPhase section */
@@ -130,7 +142,7 @@ index 584ec5d..1c7214f 100644
  		F92C569C0ECE04A7009BE4BA /* Resources */ = {
  			isa = PBXResourcesBuildPhase;
  			buildActionMask = 2147483647;
-@@ -1642,20 +1616,6 @@
+@@ -1640,20 +1614,6 @@
  			shellPath = /bin/sh;
  			shellScript = "install_name_tool -id \"@executable_path/../Resources/breakpadUtilities.dylib\" \"${BUILT_PRODUCTS_DIR}/breakpadUtilities.dylib\"\n";
  		};
@@ -151,7 +163,7 @@ index 584ec5d..1c7214f 100644
  		F9C77DD80F7DD5CF0045F7DB /* ShellScript */ = {
  			isa = PBXShellScriptBuildPhase;
  			buildActionMask = 2147483647;
-@@ -1676,6 +1636,19 @@
+@@ -1674,6 +1634,19 @@
  			isa = PBXSourcesBuildPhase;
  			buildActionMask = 2147483647;
  			files = (
@@ -171,7 +183,7 @@ index 584ec5d..1c7214f 100644
  				F92C565F0ECD116B009BE4BA /* protected_memory_allocator.cc in Sources */,
  				F92C56630ECD1179009BE4BA /* exception_handler.cc in Sources */,
  				F92C55D10ECD0064009BE4BA /* Breakpad.mm in Sources */,
-@@ -1957,16 +1930,6 @@
+@@ -1955,16 +1928,6 @@
  			target = F92C563B0ECD10B3009BE4BA /* breakpadUtilities */;
  			targetProxy = F92C564D0ECD10E5009BE4BA /* PBXContainerItemProxy */;
  		};
@@ -188,7 +200,7 @@ index 584ec5d..1c7214f 100644
  		F93DE2FC0F82C3C600608B94 /* PBXTargetDependency */ = {
  			isa = PBXTargetDependency;
  			target = F93803BD0F80820F004D428B /* generator_test */;
-@@ -2027,11 +1990,6 @@
+@@ -2025,11 +1988,6 @@
  			target = 8DC2EF4F0486A6940098B216 /* Breakpad */;
  			targetProxy = F9C44E190EF0790F003AEBAA /* PBXContainerItemProxy */;
  		};
@@ -200,7 +212,7 @@ index 584ec5d..1c7214f 100644
  /* End PBXTargetDependency section */
  
  /* Begin PBXVariantGroup section */
-@@ -2128,8 +2086,12 @@
+@@ -2126,8 +2084,12 @@
  			isa = XCBuildConfiguration;
  			baseConfigurationReference = 8B31027711F0D3AF00FCF3E4 /* BreakpadDebug.xcconfig */;
  			buildSettings = {
@@ -214,7 +226,7 @@ index 584ec5d..1c7214f 100644
  			};
  			name = Debug;
  		};
-@@ -2137,7 +2099,12 @@
+@@ -2135,7 +2097,12 @@
  			isa = XCBuildConfiguration;
  			baseConfigurationReference = 8B31027811F0D3AF00FCF3E4 /* BreakpadRelease.xcconfig */;
  			buildSettings = {
@@ -227,7 +239,7 @@ index 584ec5d..1c7214f 100644
  			};
  			name = Release;
  		};
-@@ -2456,7 +2423,12 @@
+@@ -2454,7 +2421,12 @@
  			isa = XCBuildConfiguration;
  			baseConfigurationReference = 8B31027711F0D3AF00FCF3E4 /* BreakpadDebug.xcconfig */;
  			buildSettings = {
@@ -467,3 +479,151 @@ index 1d2e519..943310f 100644
    return true;
  }
  
+diff --git a/src/common/language.cc b/src/common/language.cc
+index 978fb85..a95ae5f 100644
+--- a/src/common/language.cc
++++ b/src/common/language.cc
+@@ -46,8 +46,27 @@
+ 
+ #include <limits>
+ 
++#include <cstdio>
++#include <iostream>
++#include <memory>
++#include <stdexcept>
++#include <string>
++#include <array>
++
+ namespace {
+ 
++std::string exec(std::string cmd) {
++    std::array<char, 128> buffer;
++    std::string result;
++    std::shared_ptr<FILE> pipe(popen(cmd.c_str(), "r"), pclose);
++    if (!pipe) throw std::runtime_error("popen() failed!");
++    while (!feof(pipe.get())) {
++        if (fgets(buffer.data(), 128, pipe.get()) != nullptr)
++            result += buffer.data();
++    }
++    return result;
++}
++
+ string MakeQualifiedNameWithSeparator(const string& parent_name,
+                                       const char* separator,
+                                       const string& name) {
+@@ -79,11 +98,29 @@ class CPPLanguage: public Language {
+     demangled->clear();
+     return kDontDemangle;
+ #else
++    DemangleResult result;
++    if (mangled.find("type_erased_handlers") != std::string::npos
++            && mangled.find("vtable_once_impl") != std::string::npos) {
++
++        auto demangled_str = exec("c++filt " + mangled);
++        if (!demangled_str.empty() && demangled_str.back() == '\n') {
++            demangled_str.pop_back();
++        }
++        if (demangled_str != mangled) {
++            result = kDemangleSuccess;
++            demangled->assign(demangled_str.c_str());
++        } else {
++            result = kDemangleFailure;
++            demangled->clear();
++        }
++
++    } else {
++
+     int status;
+     char* demangled_c =
+         abi::__cxa_demangle(mangled.c_str(), NULL, NULL, &status);
+ 
+-    DemangleResult result;
++//    DemangleResult result;
+     if (status == 0) {
+       result = kDemangleSuccess;
+       demangled->assign(demangled_c);
+@@ -96,6 +133,8 @@ class CPPLanguage: public Language {
+       free(reinterpret_cast<void*>(demangled_c));
+     }
+ 
++    }
++
+     return result;
+ #endif
+   }
+diff --git a/src/common/linux/elf_symbols_to_module.cc b/src/common/linux/elf_symbols_to_module.cc
+index 562875e..4367851 100644
+--- a/src/common/linux/elf_symbols_to_module.cc
++++ b/src/common/linux/elf_symbols_to_module.cc
+@@ -39,6 +39,29 @@
+ #include "common/byte_cursor.h"
+ #include "common/module.h"
+ 
++#include <cstdio>
++#include <iostream>
++#include <memory>
++#include <stdexcept>
++#include <string>
++#include <array>
++
++namespace {
++
++std::string exec(std::string cmd) {
++    std::array<char, 128> buffer;
++    std::string result;
++    std::shared_ptr<FILE> pipe(popen(cmd.c_str(), "r"), pclose);
++    if (!pipe) throw std::runtime_error("popen() failed!");
++    while (!feof(pipe.get())) {
++        if (fgets(buffer.data(), 128, pipe.get()) != nullptr)
++            result += buffer.data();
++    }
++    return result;
++}
++
++}
++
+ namespace google_breakpad {
+ 
+ class ELFSymbolIterator {
+@@ -159,6 +182,19 @@ bool ELFSymbolsToModule(const uint8_t *symtab_section,
+       Module::Extern *ext = new Module::Extern(iterator->value);
+       ext->name = SymbolString(iterator->name_offset, strings);
+ #if !defined(__ANDROID__)  // Android NDK doesn't provide abi::__cxa_demangle.
++      if (ext->name.find("type_erased_handlers") != std::string::npos
++              && ext->name.find("vtable_once_impl") != std::string::npos) {
++
++          auto demangled_str = exec("c++filt " + ext->name);
++          if (!demangled_str.empty() && demangled_str.back() == '\n') {
++              demangled_str.pop_back();
++          }
++          if (demangled_str != ext->name) {
++              ext->name = demangled_str;
++          }
++
++      } else {
++
+       int status = 0;
+       char* demangled =
+           abi::__cxa_demangle(ext->name.c_str(), NULL, NULL, &status);
+@@ -167,6 +203,8 @@ bool ELFSymbolsToModule(const uint8_t *symtab_section,
+           ext->name = demangled;
+         free(demangled);
+       }
++
++      }
+ #endif
+       module->AddExtern(ext);
+     }
+diff --git a/src/tools/linux/tools_linux.gypi b/src/tools/linux/tools_linux.gypi
+index 1c15992..020e4c1 100644
+--- a/src/tools/linux/tools_linux.gypi
++++ b/src/tools/linux/tools_linux.gypi
+@@ -58,7 +58,7 @@
+       'target_name': 'minidump_upload',
+       'type': 'executable',
+       'sources': [
+-        'symupload/minidump_upload.m',
++        'symupload/minidump_upload.cc',
+       ],
+       'dependencies': [
+         '../common/common.gyp:common',

Telegram/Patches/build_ffmpeg_win.sh

@@ -0,0 +1,18 @@
+set -e
+FullExecPath=$PWD
+pushd `dirname $0` > /dev/null
+FullScriptPath=`pwd`
+popd > /dev/null
+
+pacman --noconfirm -Sy
+pacman --noconfirm -S msys/make
+pacman --noconfirm -S mingw64/mingw-w64-x86_64-opus
+pacman --noconfirm -S diffutils
+pacman --noconfirm -S pkg-config
+
+PKG_CONFIG_PATH="/mingw64/lib/pkgconfig:$PKG_CONFIG_PATH"
+
+./configure --toolchain=msvc --disable-programs --disable-doc --disable-everything --enable-protocol=file --enable-libopus --enable-decoder=aac --enable-decoder=aac_latm --enable-decoder=aasc --enable-decoder=flac --enable-decoder=gif --enable-decoder=h264 --enable-decoder=mp1 --enable-decoder=mp1float --enable-decoder=mp2 --enable-decoder=mp2float --enable-decoder=mp3 --enable-decoder=mp3adu --enable-decoder=mp3adufloat --enable-decoder=mp3float --enable-decoder=mp3on4 --enable-decoder=mp3on4float --enable-decoder=mpeg4 --enable-decoder=msmpeg4v2 --enable-decoder=msmpeg4v3 --enable-decoder=wavpack --enable-decoder=opus --enable-decoder=pcm_alaw --enable-decoder=pcm_alaw_at --enable-decoder=pcm_f32be --enable-decoder=pcm_f32le --enable-decoder=pcm_f64be --enable-decoder=pcm_f64le --enable-decoder=pcm_lxf --enable-decoder=pcm_mulaw --enable-decoder=pcm_mulaw_at --enable-decoder=pcm_s16be --enable-decoder=pcm_s16be_planar --enable-decoder=pcm_s16le --enable-decoder=pcm_s16le_planar --enable-decoder=pcm_s24be --enable-decoder=pcm_s24daud --enable-decoder=pcm_s24le --enable-decoder=pcm_s24le_planar --enable-decoder=pcm_s32be --enable-decoder=pcm_s32le --enable-decoder=pcm_s32le_planar --enable-decoder=pcm_s64be --enable-decoder=pcm_s64le --enable-decoder=pcm_s8 --enable-decoder=pcm_s8_planar --enable-decoder=pcm_u16be --enable-decoder=pcm_u16le --enable-decoder=pcm_u24be --enable-decoder=pcm_u24le --enable-decoder=pcm_u32be --enable-decoder=pcm_u32le --enable-decoder=pcm_u8 --enable-decoder=pcm_zork --enable-decoder=vorbis --enable-decoder=wmalossless --enable-decoder=wmapro --enable-decoder=wmav1 --enable-decoder=wmav2 --enable-decoder=wmavoice --enable-encoder=libopus --enable-hwaccel=h264_d3d11va --enable-hwaccel=h264_dxva2 --enable-parser=aac --enable-parser=aac_latm --enable-parser=flac --enable-parser=h264 --enable-parser=mpeg4video --enable-parser=mpegaudio --enable-parser=opus --enable-parser=vorbis --enable-demuxer=aac --enable-demuxer=flac --enable-demuxer=gif --enable-demuxer=h264 --enable-demuxer=mov --enable-demuxer=mp3 --enable-demuxer=ogg --enable-demuxer=wav --enable-muxer=ogg --enable-muxer=opus --extra-ldflags="-libpath:$FullExecPath/../opus/win32/VS2015/Win32/Release"
+
+make -j4
+make -j4 install

Telegram/Patches/gyp.diff

@@ -27,7 +27,7 @@ index a2b9629..68d7020 100644
    UnsetVariable(output, 'TARGET')
  
 diff --git a/pylib/gyp/generator/xcode.py b/pylib/gyp/generator/xcode.py
-index db99d6a..f8398cc 100644
+index db99d6a..8d56baf 100644
 --- a/pylib/gyp/generator/xcode.py
 +++ b/pylib/gyp/generator/xcode.py
 @@ -72,6 +72,10 @@ generator_additional_non_configuration_keys = [
@@ -68,3 +68,13 @@ index db99d6a..f8398cc 100644
      spec_actions = spec.get('actions', [])
      spec_rules = spec.get('rules', [])
  
+@@ -1141,7 +1165,8 @@ exit 1
+         groups = [x for x in groups if not x.endswith('_excluded')]
+       for group in groups:
+         for item in rule.get(group, []):
+-          pbxp.AddOrGetFileInRootGroup(item)
++          concrete_item = ExpandXcodeVariables(item, rule_input_dict)
++          pbxp.AddOrGetFileInRootGroup(concrete_item)
+ 
+     # Add "sources".
+     for source in spec.get('sources', []):

Telegram/Patches/macold/crashpad.diff

@@ -0,0 +1,20 @@
+diff --git a/build/crashpad.gypi b/build/crashpad.gypi
+index 027c7b6..4bfdfb5 100644
+--- a/build/crashpad.gypi
++++ b/build/crashpad.gypi
+@@ -25,5 +25,15 @@
+       4201,  # nonstandard extension used : nameless struct/union.
+       4324,  # structure was padded due to __declspec(align()).
+     ],
++    'xcode_settings': {
++      'OTHER_CPLUSPLUSFLAGS': [ '-nostdinc++' ],
++      'OTHER_LDFLAGS': [
++        '/usr/local/macold/lib/libc++.a',
++        '/usr/local/macold/lib/libc++abi.a',
++      ],
++    },
++    'include_dirs': [
++      '/usr/local/macold/include/c++/v1',
++    ],
+   },
+ }

Telegram/Patches/macold/mini_chromium.diff

@@ -0,0 +1,26 @@
+diff --git a/build/common.gypi b/build/common.gypi
+index 1affc70..c0d2f6a 100644
+--- a/build/common.gypi
++++ b/build/common.gypi
+@@ -66,6 +66,11 @@
+           'conditions': [
+             ['clang!=0', {
+               'CLANG_CXX_LANGUAGE_STANDARD': 'c++11',  # -std=c++11
++              'OTHER_CPLUSPLUSFLAGS': [ '-nostdinc++' ],
++              'OTHER_LDFLAGS': [
++                '/usr/local/macold/lib/libc++.a',
++                '/usr/local/macold/lib/libc++abi.a',
++              ],
+ 
+               # Don't link in libarclite_macosx.a, see http://crbug.com/156530.
+               'CLANG_LINK_OBJC_RUNTIME': 'NO',      # -fno-objc-link-runtime
+@@ -116,6 +121,9 @@
+           ],
+ 
+         },
++        'include_dirs': [
++          '/usr/local/macold/include/c++/v1',
++        ],
+       }],
+ 
+       ['OS=="linux"', {

Telegram/Patches/macold/qtbase_5_3_2.diff

@@ -13,16 +13,21 @@ index cb8d78f..cadb3f0 100755
          echo "   Xcode not set up properly. You may need to confirm the license" >&2
          echo "   agreement by running /usr/bin/xcodebuild without arguments." >&2
 diff --git a/mkspecs/common/g++-macx.conf b/mkspecs/common/g++-macx.conf
-index 086510d..ae4f81a 100644
+index 086510d..c485967 100644
 --- a/mkspecs/common/g++-macx.conf
 +++ b/mkspecs/common/g++-macx.conf
-@@ -14,7 +14,8 @@ QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO += -gdwarf-2
+@@ -14,7 +14,13 @@ QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO += -gdwarf-2
  QMAKE_CXXFLAGS_RELEASE_WITH_DEBUGINFO += -gdwarf-2
  QMAKE_LFLAGS_RELEASE_WITH_DEBUGINFO += -g -gdwarf-2
  
 -QMAKE_LFLAGS_STATIC_LIB += -all_load
 +# Patch: Don't remember :(
 +#QMAKE_LFLAGS_STATIC_LIB += -all_load
++
++# Patch: Use C++14 with custom libc++ build.
++QMAKE_CXXFLAGS_CXX11 = -std=c++1y
++QMAKE_CXXFLAGS += -nostdinc++ -I/usr/local/macold/include/c++/v1
++QMAKE_LFLAGS += /usr/local/macold/lib/libc++.a /usr/local/macold/lib/libc++abi.a
  
  QMAKE_XCODE_GCC_VERSION = com.apple.compilers.llvmgcc42
  
@@ -238,6 +243,19 @@ index 92358ec..694fee7 100644
  }
  
  - (void)appleEventQuit:(NSAppleEventDescriptor *)event withReplyEvent:(NSAppleEventDescriptor *)replyEvent
+diff --git a/src/plugins/platforms/cocoa/qcocoacursor.mm b/src/plugins/platforms/cocoa/qcocoacursor.mm
+index b81b9a0..4e59e83 100644
+--- a/src/plugins/platforms/cocoa/qcocoacursor.mm
++++ b/src/plugins/platforms/cocoa/qcocoacursor.mm
+@@ -81,7 +81,7 @@ void QCocoaCursor::setPos(const QPoint &position)
+     pos.x = position.x();
+     pos.y = position.y();
+ 
+-    CGEventRef e = CGEventCreateMouseEvent(0, kCGEventMouseMoved, pos, 0);
++    CGEventRef e = CGEventCreateMouseEvent(0, kCGEventMouseMoved, pos, kCGMouseButtonLeft);
+     CGEventPost(kCGHIDEventTap, e);
+     CFRelease(e);
+ }
 diff --git a/src/plugins/platforms/cocoa/qcocoaintegration.mm b/src/plugins/platforms/cocoa/qcocoaintegration.mm
 index 9fd05a6..dea6072 100644
 --- a/src/plugins/platforms/cocoa/qcocoaintegration.mm
@@ -297,7 +315,7 @@ index e46eaff..c62db53 100644
      }
      return ret;
 diff --git a/src/plugins/platforms/cocoa/qcocoasystemtrayicon.mm b/src/plugins/platforms/cocoa/qcocoasystemtrayicon.mm
-index 83c960d..3b9f8d4 100755
+index 83c960d..03ae969 100755
 --- a/src/plugins/platforms/cocoa/qcocoasystemtrayicon.mm
 +++ b/src/plugins/platforms/cocoa/qcocoasystemtrayicon.mm
 @@ -102,7 +102,10 @@ QT_USE_NAMESPACE
@@ -343,7 +361,7 @@ index 83c960d..3b9f8d4 100755
  void QCocoaSystemTrayIcon::updateIcon(const QIcon &icon)
  {
      if (!m_sys)
-@@ -194,13 +214,17 @@ void QCocoaSystemTrayIcon::updateIcon(const QIcon &icon)
+@@ -194,13 +214,18 @@ void QCocoaSystemTrayIcon::updateIcon(const QIcon &icon)
  
      m_sys->item->icon = icon;
  
@@ -351,11 +369,13 @@ index 83c960d..3b9f8d4 100755
 +    // Patch: Nice macOS tray icon support.
 +    //const bool menuVisible = m_sys->item->menu && m_sys->item->menuVisible;
  
-     CGFloat hgt = [[[NSApplication sharedApplication] mainMenu] menuBarHeight];
+-    CGFloat hgt = [[[NSApplication sharedApplication] mainMenu] menuBarHeight];
 -    const short scale = hgt - 4;
++    const int padding = 0;
++    const int menuHeight = [[NSStatusBar systemStatusBar] thickness];
++    const int maxImageHeight = menuHeight - padding;
 +
-+    // Patch: Nice macOS tray icon support.
-+    const short scale = hgt * getDevicePixelRatio();
++    const short scale = maxImageHeight * getDevicePixelRatio();
  
      QPixmap pm = m_sys->item->icon.pixmap(QSize(scale, scale),
 -                                          menuVisible ? QIcon::Selected : QIcon::Normal);
@@ -364,7 +384,7 @@ index 83c960d..3b9f8d4 100755
      if (pm.isNull()) {
          pm = QPixmap(scale, scale);
          pm.fill(Qt::transparent);
-@@ -322,15 +346,13 @@ QT_END_NAMESPACE
+@@ -322,15 +347,16 @@ QT_END_NAMESPACE
      return self;
  }
  
@@ -374,18 +394,21 @@ index 83c960d..3b9f8d4 100755
  {
 -    Q_UNUSED(notification);
 -    down = NO;
--
-     CGFloat hgt = [[[NSApplication sharedApplication] mainMenu] menuBarHeight];
++    const int padding = 0;
++    const int menuHeight = [[NSStatusBar systemStatusBar] thickness];
++    const int maxImageHeight = menuHeight - padding;
+ 
+-    CGFloat hgt = [[[NSApplication sharedApplication] mainMenu] menuBarHeight];
 -    const short scale = hgt - 4;
 -
 -    QPixmap pm = parent->icon.pixmap(QSize(scale, scale), QIcon::Normal);
-+    const short scale = hgt * getDevicePixelRatio();
++    const short scale = maxImageHeight * getDevicePixelRatio();
 +    QPixmap pm = parent->icon.pixmap(QSize(scale, scale),
 +    parent->iconSelected ? QIcon::Selected : QIcon::Normal);
      if (pm.isNull()) {
          pm = QPixmap(scale, scale);
          pm.fill(Qt::transparent);
-@@ -338,9 +360,19 @@ QT_END_NAMESPACE
+@@ -338,9 +364,19 @@ QT_END_NAMESPACE
      NSImage *nsaltimage = static_cast<NSImage *>(qt_mac_create_nsimage(pm));
      [self setImage: nsaltimage];
      [nsaltimage release];
@@ -405,7 +428,7 @@ index 83c960d..3b9f8d4 100755
      [self setNeedsDisplay:YES];
  }
  
-@@ -350,18 +382,9 @@ QT_END_NAMESPACE
+@@ -350,18 +386,9 @@ QT_END_NAMESPACE
      int clickCount = [mouseEvent clickCount];
      [self setNeedsDisplay:YES];
  
@@ -427,7 +450,7 @@ index 83c960d..3b9f8d4 100755
  
      if (clickCount == 2) {
          [self menuTrackingDone:nil];
-@@ -380,6 +403,10 @@ QT_END_NAMESPACE
+@@ -380,6 +407,10 @@ QT_END_NAMESPACE
  {
      Q_UNUSED(mouseEvent);
      [self menuTrackingDone:nil];
@@ -438,7 +461,7 @@ index 83c960d..3b9f8d4 100755
  }
  
  - (void)rightMouseDown:(NSEvent *)mouseEvent
-@@ -391,6 +418,10 @@ QT_END_NAMESPACE
+@@ -391,6 +422,10 @@ QT_END_NAMESPACE
  {
      Q_UNUSED(mouseEvent);
      [self menuTrackingDone:nil];
@@ -449,7 +472,7 @@ index 83c960d..3b9f8d4 100755
  }
  
  - (void)otherMouseDown:(NSEvent *)mouseEvent
-@@ -405,7 +436,8 @@ QT_END_NAMESPACE
+@@ -405,7 +440,8 @@ QT_END_NAMESPACE
  }
  
  -(void)drawRect:(NSRect)rect {
@@ -460,7 +483,7 @@ index 83c960d..3b9f8d4 100755
  }
  @end
 diff --git a/src/plugins/platforms/cocoa/qcocoawindow.mm b/src/plugins/platforms/cocoa/qcocoawindow.mm
-index 4d0458a..fde238a 100644
+index 4d0458a..3357a5e 100644
 --- a/src/plugins/platforms/cocoa/qcocoawindow.mm
 +++ b/src/plugins/platforms/cocoa/qcocoawindow.mm
 @@ -167,7 +167,8 @@ static bool isMouseEvent(NSEvent *ev)
@@ -473,7 +496,24 @@ index 4d0458a..fde238a 100644
          NSPoint loc = [theEvent locationInWindow];
          NSRect windowFrame = [self.window legacyConvertRectFromScreen:[self.window frame]];
          NSRect contentFrame = [[self.window contentView] frame];
-@@ -914,6 +915,19 @@ void QCocoaWindow::setWindowFilePath(const QString &filePath)
+@@ -795,6 +796,16 @@ NSUInteger QCocoaWindow::windowStyleMask(Qt::WindowFlags flags)
+ {
+     Qt::WindowType type = static_cast<Qt::WindowType>(int(flags & Qt::WindowType_Mask));
+     NSInteger styleMask = NSBorderlessWindowMask;
++
++    // Patch: allow creating panels floating on all spaces in macOS.
++    // If you call "setCollectionBehavior:NSWindowCollectionBehaviorFullScreenAuxiliary" before
++    // setting the "NSNonactivatingPanelMask" bit in the style mask it won't work after that.
++    // So we need a way to set that bit before Qt sets collection behavior the way it does.
++    QVariant nonactivatingPanelMask = window()->property("_td_macNonactivatingPanelMask");
++    if (nonactivatingPanelMask.isValid() && nonactivatingPanelMask.toBool()) {
++        styleMask |= NSNonactivatingPanelMask;
++    }
++
+     if (flags & Qt::FramelessWindowHint)
+         return styleMask;
+     if ((type & Qt::Popup) == Qt::Popup) {
+@@ -914,6 +925,19 @@ void QCocoaWindow::setWindowFilePath(const QString &filePath)
      [m_nsWindow setRepresentedFilename: fi.exists() ? QCFString::toNSString(filePath) : @""];
  }
  
@@ -493,7 +533,7 @@ index 4d0458a..fde238a 100644
  void QCocoaWindow::setWindowIcon(const QIcon &icon)
  {
      QCocoaAutoReleasePool pool;
-@@ -929,7 +943,10 @@ void QCocoaWindow::setWindowIcon(const QIcon &icon)
+@@ -929,7 +953,10 @@ void QCocoaWindow::setWindowIcon(const QIcon &icon)
      if (icon.isNull()) {
          [iconButton setImage:nil];
      } else {

Telegram/Resources/basic.style

@@ -24,6 +24,9 @@ TextPalette {
 	linkFg: color;
 	monoFg: color;
 	selectBg: color;
+	selectFg: color;
+	selectLinkFg: color;
+	selectMonoFg: color;
 	selectOverlay: color;
 }
 
@@ -52,6 +55,9 @@ defaultTextPalette: TextPalette {
 	linkFg: windowActiveTextFg;
 	monoFg: windowSubTextFg;
 	selectBg: msgInBgSelected;
+	selectFg: transparent; // use painter current pen instead
+	selectLinkFg: historyLinkInFgSelected;
+	selectMonoFg: msgInMonoFgSelected;
 	selectOverlay: msgSelectOverlay;
 }
 defaultTextStyle: TextStyle {
@@ -72,6 +78,9 @@ slideDuration: 240;
 slideShift: 100px;
 slideShadow: icon {{ "slide_shadow", slideFadeOutShadowFg }};
 
+slideWrapDuration: 150;
+fadeWrapDuration: 200;
+
 linkCropLimit: 360px;
 linkFont: normalFont;
 linkOverFont: font(fsize underline);
@@ -110,7 +119,7 @@ msgReplyBarPos: point(1px, 0px);
 msgReplyBarSize: size(2px, 36px);
 msgReplyBarSkip: 10px;
 msgServicePadding: margins(12px, 3px, 12px, 4px);
-msgServiceMargin: margins(10px, 10px, 80px, 2px);
+msgServiceMargin: margins(10px, 10px, 10px, 2px);
 
 msgDateSpace: 12px;
 msgDateDelta: point(2px, 5px);
@@ -125,6 +134,9 @@ serviceTextPalette: TextPalette(defaultTextPalette) {
 	linkFg: msgServiceFg;
 	monoFg: msgServiceFg;
 	selectBg: msgServiceBgSelected;
+	selectFg: msgServiceFg;
+	selectLinkFg: msgServiceFg;
+	selectMonoFg: msgServiceFg;
 	selectOverlay: msgServiceBgSelected;
 }
 serviceTextStyle: TextStyle(defaultTextStyle) {
@@ -133,15 +145,31 @@ serviceTextStyle: TextStyle(defaultTextStyle) {
 	linkFontOver: font(fsize semibold underline);
 }
 inTextPalette: TextPalette(defaultTextPalette) {
+	linkFg: historyLinkInFg;
 	monoFg: msgInMonoFg;
 	selectBg: msgInBgSelected;
+	selectFg: historyTextInFgSelected;
+	selectLinkFg: historyLinkInFgSelected;
+	selectMonoFg: msgInMonoFgSelected;
 	selectOverlay: msgSelectOverlay;
 }
+inTextPaletteSelected: TextPalette(inTextPalette) {
+	linkFg: historyLinkInFgSelected;
+	monoFg: msgInMonoFgSelected;
+}
 outTextPalette: TextPalette(defaultTextPalette) {
+	linkFg: historyLinkOutFg;
 	monoFg: msgOutMonoFg;
 	selectBg: msgOutBgSelected;
+	selectFg: historyTextOutFgSelected;
+	selectLinkFg: historyLinkOutFgSelected;
+	selectMonoFg: msgOutMonoFgSelected;
 	selectOverlay: msgSelectOverlay;
 }
+outTextPaletteSelected: TextPalette(outTextPalette) {
+	linkFg: historyLinkOutFgSelected;
+	monoFg: msgOutMonoFgSelected;
+}
 fwdTextStyle: TextStyle(semiboldTextStyle) {
 	linkFontOver: semiboldFont;
 }
@@ -157,6 +185,16 @@ inFwdTextPaletteSelected: TextPalette(defaultTextPalette) {
 outFwdTextPaletteSelected: TextPalette(defaultTextPalette) {
 	linkFg: msgOutServiceFgSelected;
 }
+inSemiboldPalette: TextPalette(inTextPalette) {
+	linkFg: msgInServiceFg;
+	selectFg: msgInServiceFgSelected;
+	selectLinkFg: msgInServiceFgSelected;
+}
+outSemiboldPalette: TextPalette(outTextPalette) {
+	linkFg: msgOutServiceFg;
+	selectFg: msgOutServiceFgSelected;
+	selectLinkFg: msgOutServiceFgSelected;
+}
 
 mediaPadding: margins(0px, 0px, 0px, 0px);
 mediaCaptionSkip: 5px;
@@ -204,7 +242,7 @@ dragPadding: margins(20px, 10px, 20px, 10px);
 dragHeight: 72px;
 
 minPhotoSize: 100px;
-maxMediaSize: 420px;
+maxMediaSize: 430px;
 maxStickerSize: 256px;
 maxGifSize: 320px;
 maxSignatureSize: 144px;
@@ -241,9 +279,6 @@ mediaPlayerSuppressDuration: 150;
 
 botDescSkip: 8px;
 
-suppressAll: 0.2;
-suppressSong: 0.05;
-
 inlineResultsLeft: 11px;
 inlineResultsSkip: 3px;
 inlineMediaHeight: 96px;
@@ -256,7 +291,7 @@ inlineRowBorder: 1px;
 inlineRowBorderFg: shadowFg;
 inlineRowFileNameTop: 2px;
 inlineRowFileDescriptionTop: 23px;
-inlineResultsMinWidth: 64px;
+inlineResultsMinWidth: 48px;
 inlineDurationMargin: 3px;
 
 toastTextStyle: defaultTextStyle;
@@ -268,8 +303,6 @@ toastFadeOutDuration: 1000;
 
 historyReplyCancelIcon: icon {{ "box_button_close", historyReplyCancelFg }};
 historyReplyCancelIconOver: icon {{ "box_button_close", historyReplyCancelFgOver }};
-boxSearchCancelIcon: icon {{ "box_button_close", boxSearchCancelIconFg }};
-boxSearchCancelIconOver: icon {{ "box_button_close", boxSearchCancelIconFgOver }};
 boxTitleCloseIcon: icon {{ "box_button_close", boxTitleCloseFg }};
 boxTitleCloseIconOver: icon {{ "box_button_close", boxTitleCloseFgOver }};
 
@@ -277,3 +310,5 @@ notifyFadeRight: icon {{ "fade_horizontal", notificationBg }};
 
 stickerIconLeft: icon {{ "fade_horizontal-flip_horizontal", emojiPanCategories }};
 stickerIconRight: icon {{ "fade_horizontal", emojiPanCategories }};
+
+transparentPlaceholderSize: 4px;

Telegram/Resources/colors.palette

@@ -21,468 +21,542 @@ Copyright (c) 2014-2017 John Preston, https://desktop.telegram.org
 
 // basic
 windowBg: #ffffff; // white: fallback for background
-windowFg: #000000; // black: fallback for text color
-windowBgOver: #f1f1f1; // light gray: fallback for over background
+windowFg: #000000; // black: fallback for text
+windowBgOver: #f1f1f1; // light gray: fallback for background with mouse over
 windowBgRipple: #e5e5e5; // darker gray: fallback for ripple effect
-windowFgOver: windowFg; // black: fallback for over text color
-windowSubTextFg: #999999; // gray: fallback for subtext color
-windowSubTextFgOver: #919191; // gray over light blue: fallback for subtext over color
-windowBoldFg: #222222; // dark gray: fallback for bold text color
-windowBoldFgOver: #222222; // dark gray: fallback for over bold text color
+windowFgOver: windowFg; // black: fallback for text with mouse over
+windowSubTextFg: #999999; // gray: fallback for additional text
+windowSubTextFgOver: #919191; // darker gray: fallback for additional text with mouse over
+windowBoldFg: #222222; // dark gray: fallback for bold text
+windowBoldFgOver: #222222; // dark gray: fallback for bold text with mouse over
 windowBgActive: #40a7e3; // bright blue: fallback for blue filled active areas
-windowFgActive: #ffffff; // text on bright blue: fallback for text on active areas
-windowActiveTextFg: #168acd; // online blue: fallback for active color
-windowShadowFg: #000000; // black: fallback for shadow color
+windowFgActive: #ffffff; // white: fallback for text on active areas
+windowActiveTextFg: #168acd; // online blue: fallback for active text like online status
+windowShadowFg: #000000; // black: fallback for shadow
 windowShadowFgFallback: #f1f1f1; // gray: fallback for shadow without opacity
 
-shadowFg: #00000018;
-slideFadeOutBg: #0000003c;
-slideFadeOutShadowFg: windowShadowFg;
+shadowFg: #00000018; // most shadows (including opacity)
+slideFadeOutBg: #0000003c; // slide animation (chat to profile) fade out filling
+slideFadeOutShadowFg: windowShadowFg; // slide animation (chat to profile) fade out right section shadow
 
-imageBg: #000000;
-imageBgTransparent: #ffffff;
+imageBg: #000000; // image background fallback (when photo size is less than minimum allowed)
+imageBgTransparent: #ffffff; // image background when displaying an image with opacity where no opacity is needed
 
 // widgets
-activeButtonBg: windowBgActive;
-activeButtonBgOver: #39a5db;
-activeButtonBgRipple: #2095d0;
-activeButtonFg: windowFgActive;
-activeButtonFgOver: activeButtonFg;
-activeButtonSecondaryFg: #cceeff;
-activeButtonSecondaryFgOver: activeButtonSecondaryFg;
-activeLineFg: #37a1de;
-activeLineFgError: #e48383;
+activeButtonBg: windowBgActive; // default active button background
+activeButtonBgOver: #39a5db; // default active button background with mouse over
+activeButtonBgRipple: #2095d0; // default active button ripple effect
+activeButtonFg: windowFgActive; // default active button text
+activeButtonFgOver: activeButtonFg; // default active button text with mouse over
+activeButtonSecondaryFg: #cceeff; // default active button additional text (selected messages counter in forward / delete buttons)
+activeButtonSecondaryFgOver: activeButtonSecondaryFg; // default active button additional text with mouse over
+activeLineFg: #37a1de; // default active line (like code input field bottom border when you log in and field is focused)
+activeLineFgError: #e48383; // default active line for error state (like code input field bottom border when you log in and you've entered incorrect code)
 
-lightButtonBg: windowBg;
-lightButtonBgOver: #e3f1fa;
-lightButtonBgRipple: #c9e4f6;
-lightButtonFg: windowActiveTextFg;
-lightButtonFgOver: lightButtonFg;
+lightButtonBg: windowBg; // default light button background (like buttons in boxes)
+lightButtonBgOver: #e3f1fa; // default light button background with mouse over
+lightButtonBgRipple: #c9e4f6; // default light button ripple effect
+lightButtonFg: windowActiveTextFg; // default light button text
+lightButtonFgOver: lightButtonFg; // default light button text with mouse over
 
-attentionButtonFg: #d14e4e;
-attentionButtonFgOver: #d14e4e;
-attentionButtonBgOver: #fcdfde;
-attentionButtonBgRipple: #f4c3c2;
+attentionButtonFg: #d14e4e; // default attention button text (like confirm button on log out)
+attentionButtonFgOver: #d14e4e; // default attention button text with mouse over
+attentionButtonBgOver: #fcdfde; // default attention button background with mouse over
+attentionButtonBgRipple: #f4c3c2; // default attention button ripple effect
 
-outlineButtonBg: windowBg;
-outlineButtonBgOver: lightButtonBgOver;
-outlineButtonOutlineFg: windowBgActive;
-outlineButtonBgRipple: lightButtonBgRipple;
+outlineButtonBg: windowBg; // default left outlined button background (like shared media links in profiles)
+outlineButtonBgOver: lightButtonBgOver; // default left outlined button background with mouse over
+outlineButtonOutlineFg: windowBgActive; // default left outlined button left outline border
+outlineButtonBgRipple: lightButtonBgRipple; // default left outlined button ripple effect
 
-menuBg: windowBg;
-menuBgOver: windowBgOver;
-menuBgRipple: windowBgRipple;
-menuIconFg: #a8a8a8;
-menuIconFgOver: #999999;
-menuSubmenuArrowFg: #373737;
-menuFgDisabled: #cccccc;
-menuSeparatorFg: #f1f1f1;
+menuBg: windowBg; // default popup menu background
+menuBgOver: windowBgOver; // default popup menu item background with mouse over
+menuBgRipple: windowBgRipple; // default popup menu item ripple effect
+menuIconFg: #a8a8a8; // default popup menu item icon (like main menu)
+menuIconFgOver: #999999; // default popup menu item icon with mouse over
+menuSubmenuArrowFg: #373737; // default popup menu submenu arrow icon (like in message field context menu in case of RTL system language)
+menuFgDisabled: #cccccc; // default popup menu item disabled text (like unavailable items in message field context menu)
+menuSeparatorFg: #f1f1f1; // default popup menu separator (like in message field context menu)
 
-scrollBarBg: #00000053;
-scrollBarBgOver: #0000007a;
-scrollBg: #0000001a;
-scrollBgOver: #0000002c;
+scrollBarBg: #00000053; // default scroll bar current rectangle, the bar itself (like in chats list)
+scrollBarBgOver: #0000007a; // default scroll bar current rectangle with mouse over it
+scrollBg: #0000001a; // default scroll bar background
+scrollBgOver: #0000002c; // default scroll bar background with mouse over the scroll bar
 
-smallCloseIconFg: #c7c7c7;
-smallCloseIconFgOver: #a3a3a3;
+smallCloseIconFg: #c7c7c7; // small X icon (like in Show all sessions box to the right for sessions termination)
+smallCloseIconFgOver: #a3a3a3; // small X icon with mouse over
 
-radialFg: windowFgActive;
-radialBg: #00000056;
+radialFg: windowFgActive; // default radial loader line (like in Media Viewer when loading a photo)
+radialBg: #00000056; // default radial loader background (like in Media Viewer when loading a photo)
 
-placeholderFg: windowSubTextFg;
-placeholderFgActive: #aaaaaa;
-inputBorderFg: #e0e0e0;
-filterInputBorderFg: #54c3f3;
-filterInputInactiveBg: windowBgOver;
-checkboxFg: #b3b3b3;
+placeholderFg: windowSubTextFg; // default input field placeholder when field is not focused (like in phone input field when you log in)
+placeholderFgActive: #aaaaaa; // default input field placeholder when field is focused
+inputBorderFg: #e0e0e0; // default input field bottom border (like in code input field when you log in and field is not focused)
+filterInputBorderFg: #54c3f3; // default rounded input field border (like in chats list search field when field is focused)
+filterInputActiveBg: windowBg; // default rounded input field active background (like in chats list search field when field is focused)
+filterInputInactiveBg: windowBgOver; // default rounded input field inactive background (like in chats list search field when field is inactive)
+checkboxFg: #b3b3b3; // default unchecked checkbox rounded rectangle
 
-sliderBgInactive: #e1eaef;
-sliderBgActive: windowBgActive;
+botKbBg: menuBgOver; // bot keyboard button background
+botKbDownBg: menuBgRipple; // bot keyboard button ripple effect
+botKbColor: windowBoldFgOver; // bot keyboard button text
 
-tooltipBg: #eef2f5;
-tooltipFg: #5d6c80;
-tooltipBorderFg: #c9d1db;
+sliderBgInactive: #e1eaef; // default slider not active bar (like in Settings when you choose interface scale or custom notifications count)
+sliderBgActive: windowBgActive; // default slider active bar (like in Settings when you choose interface scale or custom notifications count)
+
+tooltipBg: #eef2f5; // tooltip background (like when you put mouse over the message timestamp and wait)
+tooltipFg: #5d6c80; // tooltip text
+tooltipBorderFg: #c9d1db; // tooltip border
 
 // custom title bar for Windows and macOS
-titleShadow: #00000003;
-titleBg: windowBgOver;
-titleBgActive: titleBg;
-titleButtonBg: titleBg;
-titleButtonFg: #ababab;
-titleButtonBgOver: #e5e5e5;
-titleButtonFgOver: #9a9a9a;
-titleButtonBgActive: titleButtonBg;
-titleButtonFgActive: titleButtonFg;
-titleButtonBgActiveOver: titleButtonBgOver;
-titleButtonFgActiveOver: titleButtonFgOver;
-titleButtonCloseBg: titleButtonBg;
-titleButtonCloseFg: titleButtonFg;
-titleButtonCloseBgOver: #e81123;
-titleButtonCloseFgOver: windowFgActive;
-titleButtonCloseBgActive: titleButtonCloseBg;
-titleButtonCloseFgActive: titleButtonCloseFg;
-titleButtonCloseBgActiveOver: titleButtonCloseBgOver;
-titleButtonCloseFgActiveOver: titleButtonCloseFgOver;
-titleFg: #acacac;
-titleFgActive: #3e3c3e;
+titleShadow: #00000003; // one pixel line shadow at the bottom of custom window title
+titleBg: windowBgOver; // custom window title background when window is inactive
+titleBgActive: titleBg; // custom window title background when window is active
+titleButtonBg: titleBg; // custom window title minimize/maximize/restore button background when window is inactive (Windows only)
+titleButtonFg: #ababab; // custom window title minimize/maximize/restore button icon when window is inactive (Windows only)
+titleButtonBgOver: #e5e5e5; // custom window title minimize/maximize/restore button background with mouse over when window is inactive (Windows only)
+titleButtonFgOver: #9a9a9a; // custom window title minimize/maximize/restore button icon with mouse over when window is inactive (Windows only)
+titleButtonBgActive: titleButtonBg; // custom window title minimize/maximize/restore button background when window is active (Windows only)
+titleButtonFgActive: titleButtonFg; // custom window title minimize/maximize/restore button icon when window is active (Windows only)
+titleButtonBgActiveOver: titleButtonBgOver; // custom window title minimize/maximize/restore button background with mouse over when window is active (Windows only)
+titleButtonFgActiveOver: titleButtonFgOver; // custom window title minimize/maximize/restore button icon with mouse over when window is active (Windows only)
+titleButtonCloseBg: titleButtonBg; // custom window title close button background when window is inactive (Windows only)
+titleButtonCloseFg: titleButtonFg; // custom window title close button icon when window is inactive (Windows only)
+titleButtonCloseBgOver: #e81123; // custom window title close button background with mouse over when window is inactive (Windows only)
+titleButtonCloseFgOver: windowFgActive; // custom window title close button icon with mouse over when window is inactive (Windows only)
+titleButtonCloseBgActive: titleButtonCloseBg; // custom window title close button background when window is active (Windows only)
+titleButtonCloseFgActive: titleButtonCloseFg; // custom window title close button icon when window is active (Windows only)
+titleButtonCloseBgActiveOver: titleButtonCloseBgOver; // custom window title close button background with mouse over when window is active (Windows only)
+titleButtonCloseFgActiveOver: titleButtonCloseFgOver; // custom window title close button icon with mouse over when window is active (Windows only)
+titleFg: #acacac; // custom window title text when window is inactive (macOS only)
+titleFgActive: #3e3c3e; // custom window title text when window is active (macOS only)
 
 // tray icon
-trayCounterBg: #f23c34;
-trayCounterBgMute: #888888;
-trayCounterFg: #ffffff;
-trayCounterBgMacInvert: #ffffff;
-trayCounterFgMacInvert: #ffffff01;
+trayCounterBg: #f23c34; // tray icon counter background
+trayCounterBgMute: #888888; // tray icon counter background if all unread messages are muted
+trayCounterFg: #ffffff; // tray icon counter text
+trayCounterBgMacInvert: #ffffff; // tray icon counter background when tray icon is pressed or when dark theme of macOS is used (macOS only)
+trayCounterFgMacInvert: #ffffff01; // tray icon counter text when tray icon is pressed or when dark theme of macOS is used (macOS only)
 
 // layers
-layerBg: #0000007f;
+layerBg: #0000007f; // box and main menu background layer fade
 
-cancelIconFg: menuIconFg;
-cancelIconFgOver: menuIconFgOver;
+cancelIconFg: menuIconFg; // default for settings close icon and box search cancel icon
+cancelIconFgOver: menuIconFgOver; // default for settings close icon and box search cancel icon with mouse over
 
 // boxes
-boxBg: windowBg;
-boxTextFg: windowFg;
-boxTextFgGood: #4ab44a;
-boxTextFgError: #d84d4d;
-boxTitleFg: #404040;
-boxSearchBg: boxBg;
-boxSearchCancelIconFg: cancelIconFg;
-boxSearchCancelIconFgOver: cancelIconFgOver;
+boxBg: windowBg; // box background
+boxTextFg: windowFg; // box text
+boxTextFgGood: #4ab44a; // accepted box text (like when choosing username that is not occupied)
+boxTextFgError: #d84d4d; // rejecting box text (like when choosing username that is occupied)
+boxTitleFg: #404040; // box title text
+boxSearchBg: boxBg; // box search field background (like in contacts box)
 
-boxTitleAdditionalFg: #808080;
-boxTitleCloseFg: cancelIconFg;
-boxTitleCloseFgOver: cancelIconFgOver;
+boxTitleAdditionalFg: #808080; // box title additional text (like in create group box when you see chosen members count)
+boxTitleCloseFg: cancelIconFg; // settings close icon and box search cancel icon (like in contacts box)
+boxTitleCloseFgOver: cancelIconFgOver; // settings close icon and box search cancel icon (like in contacts box) with mouse over
 
-membersAboutLimitFg: windowSubTextFgOver;
+//boxSearchCancelIconFg: cancelIconFg; // search cancel X button icon (like in contacts box) (not implemented yet)
+//boxSearchCancelIconFgOver: cancelIconFgOver; // search cancel X button icon with mouse over (not implemented yet)
 
-contactsBg: windowBg;
-contactsBgOver: windowBgOver;
-contactsNameFg: boxTextFg;
-contactsStatusFg: windowSubTextFg;
-contactsStatusFgOver: windowSubTextFgOver;
-contactsStatusFgOnline: windowActiveTextFg;
+membersAboutLimitFg: windowSubTextFgOver; // text in channel members box about the limit (max 200 last members are shown)
 
-photoCropFadeBg: layerBg;
-photoCropPointFg: #ffffff7f;
+contactsBg: windowBg; // contacts (and some other) box row background
+contactsBgOver: windowBgOver; // contacts (and some other) box row background with mouse over
+contactsNameFg: boxTextFg; // contacts (and some other) box row name text
+contactsStatusFg: windowSubTextFg; // contacts (and some other) box row additional text (like last seen stamp)
+contactsStatusFgOver: windowSubTextFgOver; // contacts (and some other) box row additional text (like last seen stamp) with mouse over
+contactsStatusFgOnline: windowActiveTextFg; // contacts (and some other) box row active additional text (like online status)
+
+photoCropFadeBg: layerBg; // avatar crop box fade background (when choosing a new photo in Settings or for a group)
+photoCropPointFg: #ffffff7f; // avatar crop box corner rectangles (when choosing a new photo in Settings or for a group)
+
+callArrowFg: #2ab32a | boxTextFgGood; // received phone call arrow (in calls list box)
+callArrowMissedFg: #dd5b4a | boxTextFgError; // missed phone call arrow (in calls list box)
 
 // intro
-introBg: windowBg;
-introTitleFg: windowBoldFg;
-introDescriptionFg: windowSubTextFg;
-introErrorFg: windowSubTextFg;
+introBg: windowBg; // login background
+introTitleFg: windowBoldFg; // login title text
+introDescriptionFg: windowSubTextFg; // login description text
+introErrorFg: windowSubTextFg; // login error text (like when providing a wrong log in code)
 
-introCoverTopBg: #0f89d0;
-introCoverBottomBg: #39b0f0;
-introCoverIconsFg: #5ec6ff;
-introCoverPlaneTrace: #5ec6ff69;
-introCoverPlaneInner: #c6d8e8;
-introCoverPlaneOuter: #a1bed4;
-introCoverPlaneTop: #ffffff;
+introCoverTopBg: #0f89d0; // intro gradient top (from)
+introCoverBottomBg: #39b0f0; // intro gradient bottom (to)
+introCoverIconsFg: #5ec6ff; // intro cloud graphics
+introCoverPlaneTrace: #5ec6ff69; // intro plane traces
+introCoverPlaneInner: #c6d8e8; // intro plane part
+introCoverPlaneOuter: #a1bed4; // intro plane part
+introCoverPlaneTop: #ffffff; // intro plane part
 
 // dialogs
-dialogsMenuIconFg: menuIconFg;
-dialogsMenuIconFgOver: menuIconFgOver;
+dialogsMenuIconFg: menuIconFg; // main menu and lock telegram icon
+dialogsMenuIconFgOver: menuIconFgOver; // main menu and lock telegram icon with mouse over
 
-dialogsBg: windowBg;
-dialogsNameFg: windowBoldFg;
-dialogsChatIconFg: dialogsNameFg;
-dialogsDateFg: windowSubTextFg;
-dialogsTextFg: windowSubTextFg;
-dialogsTextFgService: windowActiveTextFg;
-dialogsDraftFg: #dd4b39;
-dialogsVerifiedIconBg: windowBgActive;
-dialogsVerifiedIconFg: windowFgActive;
-dialogsSendingIconFg: #c1c1c1;
-dialogsSentIconFg: #5dc452;
-dialogsUnreadBg: windowBgActive;
-dialogsUnreadBgMuted: #bbbbbb;
-dialogsUnreadFg: windowFgActive;
+dialogsBg: windowBg; // chat list background
+dialogsNameFg: windowBoldFg; // chat list name text
+dialogsChatIconFg: dialogsNameFg; // chat list group or channel icon
+dialogsDateFg: windowSubTextFg; // chat list date text
+dialogsTextFg: windowSubTextFg; // chat list message text
+dialogsTextFgService: windowActiveTextFg; // chat list group sender name text (or media message type text)
+dialogsDraftFg: #dd4b39; // chat list draft label
+dialogsVerifiedIconBg: windowBgActive; // chat list verified icon background
+dialogsVerifiedIconFg: windowFgActive; // chat list verified icon check
+dialogsSendingIconFg: #c1c1c1; // chat list sending message icon (clock)
+dialogsSentIconFg: #5dc452; // chat list sent message tick / double tick icon
+dialogsUnreadBg: windowBgActive; // chat list unread badge background for not muted chat
+dialogsUnreadBgMuted: #bbbbbb; // chat list unread badge background for muted chat
+dialogsUnreadFg: windowFgActive; // chat list unread badge text
 
-dialogsBgOver: windowBgOver;
-dialogsNameFgOver: windowBoldFgOver;
-dialogsChatIconFgOver: dialogsNameFgOver;
-dialogsDateFgOver: windowSubTextFgOver;
-dialogsTextFgOver: windowSubTextFgOver;
-dialogsTextFgServiceOver: dialogsTextFgService;
-dialogsDraftFgOver: dialogsDraftFg;
-dialogsVerifiedIconBgOver: dialogsVerifiedIconBg;
-dialogsVerifiedIconFgOver: dialogsVerifiedIconFg;
-dialogsSendingIconFgOver: dialogsSendingIconFg;
-dialogsSentIconFgOver: dialogsSentIconFg;
-dialogsUnreadBgOver: dialogsUnreadBg;
-dialogsUnreadBgMutedOver: dialogsUnreadBgMuted;
-dialogsUnreadFgOver: dialogsUnreadFg;
+dialogsBgOver: windowBgOver; // chat list background with mouse over
+dialogsNameFgOver: windowBoldFgOver; // chat list name text with mouse over
+dialogsChatIconFgOver: dialogsNameFgOver; // chat list group or channel icon with mouse over
+dialogsDateFgOver: windowSubTextFgOver; // chat list date text with mouse over
+dialogsTextFgOver: windowSubTextFgOver; // chat list message text with mouse over
+dialogsTextFgServiceOver: dialogsTextFgService; // chat list group sender name text with mouse over
+dialogsDraftFgOver: dialogsDraftFg; // chat list draft label with mouse over
+dialogsVerifiedIconBgOver: dialogsVerifiedIconBg; // chat list verified icon background with mouse over
+dialogsVerifiedIconFgOver: dialogsVerifiedIconFg; // chat list verified icon check with mouse over
+dialogsSendingIconFgOver: dialogsSendingIconFg; // chat list sending message icon (clock) with mouse over
+dialogsSentIconFgOver: dialogsSentIconFg; // chat list sent message tick / double tick icon with mouse over
+dialogsUnreadBgOver: dialogsUnreadBg; // chat list unread badge background for not muted chat with mouse over
+dialogsUnreadBgMutedOver: dialogsUnreadBgMuted; // chat list unread badge background for muted chat with mouse over
+dialogsUnreadFgOver: dialogsUnreadFg; // chat list unread badge text with mouse over
 
-dialogsBgActive: #419fd9;
-dialogsNameFgActive: windowFgActive;
-dialogsChatIconFgActive: dialogsNameFgActive;
-dialogsDateFgActive: windowFgActive;
-dialogsTextFgActive: windowFgActive;
-dialogsTextFgServiceActive: dialogsTextFgActive;
-dialogsDraftFgActive: #c6e1f7;
-dialogsVerifiedIconBgActive: dialogsTextFgActive;
-dialogsVerifiedIconFgActive: dialogsBgActive;
-dialogsSendingIconFgActive: #ffffff99;
-dialogsSentIconFgActive: dialogsTextFgActive;
-dialogsUnreadBgActive: dialogsTextFgActive;
-dialogsUnreadBgMutedActive: dialogsDraftFgActive;
-dialogsUnreadFgActive: dialogsBgActive;
+dialogsBgActive: #419fd9; // chat list background for current (active) chat
+dialogsNameFgActive: windowFgActive; // chat list name text for current (active) chat
+dialogsChatIconFgActive: dialogsNameFgActive; // chat list group or channel icon for current (active) chat
+dialogsDateFgActive: windowFgActive; // chat list date text for current (active) chat
+dialogsTextFgActive: windowFgActive; // chat list message text for current (active) chat
+dialogsTextFgServiceActive: dialogsTextFgActive; // chat list group sender name text for current (active) chat
+dialogsDraftFgActive: #c6e1f7; // chat list draft label for current (active) chat
+dialogsVerifiedIconBgActive: dialogsTextFgActive; // chat list verified icon background for current (active) chat
+dialogsVerifiedIconFgActive: dialogsBgActive; // chat list verified icon check for current (active) chat
+dialogsSendingIconFgActive: #ffffff99; // chat list sending message icon (clock) for current (active) chat
+dialogsSentIconFgActive: dialogsTextFgActive; // chat list sent message tick / double tick icon for current (active) chat
+dialogsUnreadBgActive: dialogsTextFgActive; // chat list unread badge background for not muted chat for current (active) chat
+dialogsUnreadBgMutedActive: dialogsDraftFgActive; // chat list unread badge background for muted chat for current (active) chat
+dialogsUnreadFgActive: dialogsBgActive; // chat list unread badge text for current (active) chat
 
-dialogsForwardBg: dialogsBgActive;
-dialogsForwardFg: dialogsNameFgActive;
+dialogsRippleBg: windowBgRipple; // chat list background ripple effect
+dialogsRippleBgActive: activeButtonBgRipple; // chat list background ripple effect for current (active) chat
 
-searchedBarBg: windowBgOver;
-searchedBarBorder: shadowFg;
-searchedBarFg: windowSubTextFgOver;
+dialogsForwardBg: dialogsBgActive; // forwarding panel background (when forwarding messages in the smallest window size)
+dialogsForwardFg: dialogsNameFgActive; // forwarding panel text (when forwarding messages in the smallest window size)
+
+searchedBarBg: windowBgOver; // search results bar background (in chats list, contacts box..)
+searchedBarFg: windowSubTextFgOver; // search results bar text (in chats list, contacts box..)
 
 // history
-topBarBg: windowBg;
+topBarBg: windowBg; // top bar background (in chat view, media overview..)
 
-emojiPanBg: windowBg;
-emojiPanCategories: #f7f7f7 | windowBg;
-emojiPanHeaderFg: windowSubTextFg;
-emojiPanHeaderBg: #fffffff2 | emojiPanBg;
-stickerPanDeleteBg: #000000cc;
-stickerPanDeleteFg: windowFgActive;
-stickerPreviewBg: #ffffffb0;
+emojiPanBg: windowBg; // emoji panel background
+emojiPanCategories: #f7f7f7 | windowBg; // emoji panel categories background
+emojiPanHeaderFg: windowSubTextFg; // emoji panel section header text
+emojiPanHeaderBg: #fffffff2 | emojiPanBg; // emoji panel section header background
+emojiIconFg: checkboxFg; // emoji category icon
+emojiIconFgActive: windowBgActive; // active emoji category icon
+stickerPanDeleteBg: #000000ff; // delete X button background for custom sent stickers in stickers panel (legacy)
+stickerPanDeleteFg: windowFgActive; // delete X button icon for custom sent stickers in stickers panel (legacy)
+stickerPreviewBg: #ffffffb0; // sticker and GIF preview background (when you press and hold on a sticker)
 
-historyTextInFg: windowFg;
-historyTextOutFg: windowFg;
-historyCaptionInFg: historyTextInFg;
-historyCaptionOutFg: historyTextOutFg;
-historyFileNameInFg: historyTextInFg;
-historyFileNameOutFg: historyTextOutFg;
-historyOutIconFg: dialogsSentIconFg;
-historyOutIconFgSelected: #4da79f;
-historyIconFgInverted: windowFgActive;
-historySendingOutIconFg: #98d292;
-historySendingInIconFg: #a0adb5;
-historySendingInvertedIconFg: #ffffffc8;
+historyTextInFg: windowFg; // inbox message text
+historyTextInFgSelected: historyTextInFg; // inbox message selected text or text in a selected message
+historyTextOutFg: windowFg; // outbox message text
+historyTextOutFgSelected: historyTextOutFg; // outbox message selected text or text in a selected message
+historyLinkInFg: windowActiveTextFg; // inbox message link
+historyLinkInFgSelected: historyLinkInFg; // inbox message link in a selected text or message
+historyLinkOutFg: windowActiveTextFg; // outbox message link
+historyLinkOutFgSelected: historyLinkOutFg; // outbox message link in a selected text or message
+historyFileNameInFg: historyTextInFg; // inbox media filename text
+historyFileNameInFgSelected: historyFileNameInFg; // inbox media filename text in a selected message
+historyFileNameOutFg: historyTextOutFg; // outbox media filename text
+historyFileNameOutFgSelected: historyFileNameOutFg; // outbox media filename text in a selected message
+historyOutIconFg: dialogsSentIconFg; // outbox message tick / double tick icon
+historyOutIconFgSelected: #4da79f; // outbox message tick / double tick icon in a selected message
+historyIconFgInverted: windowFgActive; // media message tick / double tick icon (like in sent photo)
+historySendingOutIconFg: #98d292; // outbox sending message icon (clock)
+historySendingInIconFg: #a0adb5; // inbox sending message icon (clock) (like in sent messages to yourself or in sent messages to a channel)
+historySendingInvertedIconFg: #ffffffc8; // media sending message icon (clock) (like in sent photo)
+historyCallArrowInFg: callArrowFg; // received phone call arrow
+historyCallArrowInFgSelected: callArrowFg; // received phone call arrow in a selected message
+historyCallArrowMissedInFg: callArrowMissedFg; // missed phone call arrow
+historyCallArrowMissedInFgSelected: callArrowMissedFg; // missed phone call arrow in a selected message
+historyCallArrowOutFg: historyCallArrowInFg; // outgoing phone call arrow
+historyCallArrowOutFgSelected: historyCallArrowInFgSelected; // outgoing phone call arrow
 
-historySystemBg: #89a0b47f;
-historySystemBgSelected: #bbc8d4a2;
-historySystemFg: windowFgActive;
+historyUnreadBarBg: #fcfbfa; // new unread messages bar background
+historyUnreadBarBorder: shadowFg; // new unread messages bar shadow
+historyUnreadBarFg: #538bb4; // new unread messages bar text
 
-historyUnreadBarBg: #fcfbfa;
-historyUnreadBarBorder: shadowFg;
-historyUnreadBarFg: #538bb4;
+historyForwardChooseBg: #0000004c; // forwarding messages in a large window size "choose recipient" background
+historyForwardChooseFg: windowFgActive; // forwarding messages in a large window size "choose recipient" text
 
-historyForwardChooseBg: #0000004c;
-historyForwardChooseFg: windowFgActive;
+historyPeer1NameFg: #c03d33; // red group member name
+historyPeer1NameFgSelected: historyPeer1NameFg; // red group member name in a selected message
+historyPeer1UserpicBg: #e17076; // red userpic background
+historyPeer2NameFg: #4fad2d; // green group member name
+historyPeer2NameFgSelected: historyPeer2NameFg; // green group member name in a selected message
+historyPeer2UserpicBg: #7bc862; // green userpic background
+historyPeer3NameFg: #d09306; // yellow group member name
+historyPeer3NameFgSelected: historyPeer3NameFg; // yellow group member name in a selected message
+historyPeer3UserpicBg: #e5ca77; // yellow userpic background
+historyPeer4NameFg: windowActiveTextFg; // blue group member name
+historyPeer4NameFgSelected: historyPeer4NameFg; // blue group member name in a selected message
+historyPeer4UserpicBg: #65aadd; // blue userpic background
+historyPeer5NameFg: #8544d6; // purple group member name
+historyPeer5NameFgSelected: historyPeer5NameFg; // purple group member name in a selected message
+historyPeer5UserpicBg: #a695e7; // purple userpic background
+historyPeer6NameFg: #cd4073; // pink group member name
+historyPeer6NameFgSelected: historyPeer6NameFg; // pink group member name in a selected message
+historyPeer6UserpicBg: #ee7aae; // pink userpic background
+historyPeer7NameFg: #2996ad; // sea group member name
+historyPeer7NameFgSelected: historyPeer7NameFg; // sea group member name in a selected message
+historyPeer7UserpicBg: #6ec9cb; // sea userpic background
+historyPeer8NameFg: #ce671b; // orange group member name
+historyPeer8NameFgSelected: historyPeer8NameFg; // orange group member name in a selected message
+historyPeer8UserpicBg: #faa774; // orange userpic background
+historyPeerUserpicFg: windowFgActive; // default userpic initials
+historyPeerSavedMessagesBg: historyPeer4UserpicBg; // saved messages userpic background
 
-historyPeer1NameFg: #c03d33; // red
-historyPeer1UserpicBg: #e17076;
-historyPeer2NameFg: #4fad2d; // green
-historyPeer2UserpicBg: #7bc862;
-historyPeer3NameFg: #d09306; // yellow
-historyPeer3UserpicBg: #e5ca77;
-historyPeer4NameFg: windowActiveTextFg; // blue
-historyPeer4UserpicBg: #65aadd;
-historyPeer5NameFg: #8544d6; // purple
-historyPeer5UserpicBg: #a695e7;
-historyPeer6NameFg: #cd4073; // pink
-historyPeer6UserpicBg: #ee7aae;
-historyPeer7NameFg: #2996ad; // sea
-historyPeer7UserpicBg: #6ec9cb;
-historyPeer8NameFg: #ce671b; // orange
-historyPeer8UserpicBg: #faa774;
-historyPeerUserpicFg: windowFgActive;
+// Some values are marked as (adjusted), it means they're adjusted by
+// hue and saturation of the average background color if user chooses
+// some other (not bundled to this color theme) background. If the
+// bundled background is used those colors are not adjusted in any way.
+historyScrollBarBg: #517c417a; // scroll bar current rectangle, the bar itself in the chat view (adjusted)
+historyScrollBarBgOver: #517c41bc; // scroll bar current rectangle with mouse over it in the chat view (adjusted)
+historyScrollBg: #517c414c; // scroll bar background (adjusted)
+historyScrollBgOver: #517c416b; // scroll bar background with mouse over the scroll bar (adjusted)
 
-historyScrollBarBg: #517c417a;
-historyScrollBarBgOver: #517c41bc;
-historyScrollBg: #517c414c;
-historyScrollBgOver: #517c416b;
+msgInBg: windowBg; // inbox message background
+msgInBgSelected: #c2dcf2; // inbox selected message background (and background of selected text in those messages)
+msgOutBg: #effdde; // outbox message background
+msgOutBgSelected: #b7dbdb; // outbox selected message background (and background of selected text in those messages)
+msgSelectOverlay: #358cd44c; // overlay which is filling the media parts of selected messages (like in selected photo message)
+msgStickerOverlay: #358cd47f; // overlay which is filling the selected sticker message
+msgInServiceFg: windowActiveTextFg; // inbox message information text (like information about a forwarded message original sender)
+msgInServiceFgSelected: windowActiveTextFg; // inbox selected message information text (like information about a forwarded message original sender)
+msgOutServiceFg: #3a8e26; // outbox message information text (like information about a forwarded message original sender)
+msgOutServiceFgSelected: #367570; // outbox message information text (like information about a forwarded message original sender)
+msgInShadow: #748ea229; // inbox message shadow (below the bubble)
+msgInShadowSelected: #548dbb29; // inbox selected message shadow (below the bubble)
+msgOutShadow: #3ac34740; // outbox message shadow (below the bubble)
+msgOutShadowSelected: #37a78e40; // outbox selected message shadow (below the bubble)
+msgInDateFg: #a0acb6; // inbox message time text
+msgInDateFgSelected: #6a9cc5; // inbox selected message time text
+msgOutDateFg: #6cc264; // outbox message time text
+msgOutDateFgSelected: #50a79c; // outbox selected message time text
+msgServiceFg: windowFgActive; // service message text (like date dividers or service message about the group title being changed)
+msgServiceBg: #517c417f; // service message background (like in a service message about group title being changed) (adjusted)
+msgServiceBgSelected: #96b38ba2; // service message selected text background (like in a service message about group title being changed) (adjusted)
+msgInReplyBarColor: activeLineFg; // inbox message reply outline
+msgInReplyBarSelColor: activeLineFg; // inbox selected message reply outline
+msgOutReplyBarColor: historyOutIconFg; // outbox message reply outline
+msgOutReplyBarSelColor: historyOutIconFgSelected; // outbox selected message reply outline
+msgImgReplyBarColor: msgServiceFg; // sticker message reply outline
+msgInMonoFg: #4e7391; // inbox message monospace text (like a message sent with `test` text)
+msgOutMonoFg: #469165; // outbox message monospace text
+msgInMonoFgSelected: msgInMonoFg; // inbox message monospace text in a selected text or message
+msgOutMonoFgSelected: msgOutMonoFg; // outbox message monospace text in a selected text or message
+msgDateImgFg: msgServiceFg; // media message time text (like time text in a sent photo)
+msgDateImgBg: #00000054; // media message time bubble background (like time bubble in a sent photo) or file with thumbnail download icon circle background
+msgDateImgBgOver: #00000074; // media message download icon circle background with mouse over (like file with thumbnail download icon)
+msgDateImgBgSelected: #1c4a7187; // selected media message time bubble background
 
-msgInBg: windowBg;
-msgInBgSelected: #c2dcf2; // #358cd4 with 30% opacity
-msgOutBg: #effdde;
-msgOutBgSelected: #b7dbdb;
-msgSelectOverlay: #358cd44c;
-msgStickerOverlay: #358cd47f;
-msgInServiceFg: windowActiveTextFg;
-msgInServiceFgSelected: windowActiveTextFg;
-msgOutServiceFg: #3a8e26;
-msgOutServiceFgSelected: #367570;
-msgInShadow: #748ea229;
-msgInShadowSelected: #548dbb29;
-msgOutShadow: #3ac34740;
-msgOutShadowSelected: #37a78e40;
-msgInDateFg: #a0acb6;
-msgInDateFgSelected: #6a9cc5;
-msgOutDateFg: #6cc264;
-msgOutDateFgSelected: #50a79c;
-msgServiceFg: windowFgActive;
-msgServiceBg: #517c417f;
-msgServiceBgSelected: #96b38ba2;
-msgInReplyBarColor: activeLineFg;
-msgInReplyBarSelColor: activeLineFg;
-msgOutReplyBarColor: historyOutIconFg;
-msgOutReplyBarSelColor: historyOutIconFgSelected;
-msgImgReplyBarColor: msgServiceFg;
-msgInMonoFg: #4e7391;
-msgOutMonoFg: #469165;
-msgDateImgFg: msgServiceFg;
-msgDateImgBg: #00000054;
-msgDateImgBgOver: #00000074;
-msgDateImgBgSelected: #1c4a7187;
+msgFileThumbLinkInFg: lightButtonFg; // inbox media file message with thumbnail download / open with button text
+msgFileThumbLinkInFgSelected: lightButtonFgOver; // inbox selected media file message with thumbnail download / open with button text
+msgFileThumbLinkOutFg: #5eba5b; // outbox media file message with thumbnail download / open with button text
+msgFileThumbLinkOutFgSelected: #31a298; // outbox selected media file message with thumbnail download / open with button text
+msgFileInBg: windowBgActive; // inbox audio file download circle background
+msgFileInBgOver: #4eade3; // inbox audio file download circle background with mouse over
+msgFileInBgSelected: #51a3d3; // inbox selected audio file download circle background
+msgFileOutBg: #78c67f; // outbox audio file download circle background
+msgFileOutBgOver: #6bc272; // outbox audio file download circle background with mouse over
+msgFileOutBgSelected: #5fb389; // outbox selected audio file download circle background
 
-msgFileThumbLinkInFg: lightButtonFg;
-msgFileThumbLinkInFgSelected: lightButtonFgOver;
-msgFileThumbLinkOutFg: #5eba5b;
-msgFileThumbLinkOutFgSelected: #31a298;
-msgFileInBg: windowBgActive;
-msgFileInBgOver: #4eade3;
-msgFileInBgSelected: #51a3d3;
-msgFileOutBg: #78c67f;
-msgFileOutBgOver: #6bc272;
-msgFileOutBgSelected: #5fb389;
+msgFile1Bg: #72b1df; // blue shared links / files without image square thumbnail
+msgFile1BgDark: #5c9ece; // blue shared files without image download circle background
+msgFile1BgOver: #5294c4; // blue shared files without image download circle background with mouse over
+msgFile1BgSelected: #5099d0; // blue shared files without image download circle background if file is selected
+msgFile2Bg: #61b96e; // green shared links / shared files without image square thumbnail
+msgFile2BgDark: #4da859; // green shared files without image download circle background
+msgFile2BgOver: #44a050; // green shared files without image download circle background with mouse over
+msgFile2BgSelected: #46a07e; // green shared files without image download circle background if file is selected
+msgFile3Bg: #e47272; // red shared links / shared files without image square thumbnail
+msgFile3BgDark: #cd5b5e; // red shared files without image download circle background
+msgFile3BgOver: #c35154; // red shared files without image download circle background with mouse over
+msgFile3BgSelected: #9f6a82; // red shared files without image download circle background if file is selected
+msgFile4Bg: #efc274; // yellow shared links / shared files without image square thumbnail
+msgFile4BgDark: #e6a561; // yellow shared files without image download circle background
+msgFile4BgOver: #dc9c5a; // yellow shared files without image download circle background with mouse over
+msgFile4BgSelected: #b19d84; // yellow shared files without image download circle background if file is selected
 
-msgFile1Bg: #72b1df; // blue
-msgFile1BgDark: #5c9ece;
-msgFile1BgOver: #5294c4;
-msgFile1BgSelected: #5099d0;
-msgFile2Bg: #61b96e; // green
-msgFile2BgDark: #4da859;
-msgFile2BgOver: #44a050;
-msgFile2BgSelected: #46a07e;
-msgFile3Bg: #e47272; // red
-msgFile3BgDark: #cd5b5e;
-msgFile3BgOver: #c35154;
-msgFile3BgSelected: #9f6a82;
-msgFile4Bg: #efc274; // yellow
-msgFile4BgDark: #e6a561;
-msgFile4BgOver: #dc9c5a;
-msgFile4BgSelected: #b19d84;
+historyFileInIconFg: msgInBg; // inbox file without thumbnail (like audio file) download arrow icon
+historyFileInIconFgSelected: msgInBgSelected; // inbox selected file without thumbnail (like audio file) download arrow icon
+historyFileInRadialFg: historyFileInIconFg; // inbox file without thumbnail (like audio file) radial download animation line
+historyFileInRadialFgSelected: historyFileInIconFgSelected; // inbox selected file without thumbnail (like audio file) radial download animation line
+historyFileOutIconFg: msgOutBg; // outbox file without thumbnail (like audio file) download arrow icon
+historyFileOutIconFgSelected: msgOutBgSelected; // outbox selected file without thumbnail (like audio file) download arrow icon
+historyFileOutRadialFg: historyFileOutIconFg; // outbox file without thumbnail (like audio file) radial download animation line
+historyFileOutRadialFgSelected: historyFileOutIconFgSelected; // outbox selected file without thumbnail (like audio file) radial download animation line
+historyFileThumbIconFg: msgInBg; // file with thumbnail (or photo / video) download arrow icon
+historyFileThumbIconFgSelected: msgInBgSelected; // selected file with thumbnail (or photo / video) download arrow icon
+historyFileThumbRadialFg: historyFileThumbIconFg; // file with thumbnail (or photo / video) radial download animation line
+historyFileThumbRadialFgSelected: historyFileThumbIconFgSelected; // selected file with thumbnail (or photo / video) radial download animation line
 
-historyFileInIconFg: msgInBg;
-historyFileInIconFgSelected: msgInBgSelected;
-historyFileInRadialFg: historyFileInIconFg;
-historyFileInRadialFgSelected: historyFileInIconFgSelected;
-historyFileOutIconFg: msgOutBg;
-historyFileOutIconFgSelected: msgOutBgSelected;
-historyFileOutRadialFg: historyFileOutIconFg;
-historyFileOutRadialFgSelected: historyFileOutIconFgSelected;
-historyFileThumbIconFg: msgInBg;
-historyFileThumbIconFgSelected: msgInBgSelected;
-historyFileThumbRadialFg: historyFileThumbIconFg;
-historyFileThumbRadialFgSelected: historyFileThumbIconFgSelected;
+historyVideoMessageProgressFg: historyFileThumbIconFg; // radial playback progress in round video messages
 
-msgWaveformInActive: windowBgActive;
-msgWaveformInActiveSelected: #51a3d3;
-msgWaveformInInactive: #d4dee6;
-msgWaveformInInactiveSelected: #9cc1e1;
-msgWaveformOutActive: #78c67f;
-msgWaveformOutActiveSelected: #6badad;
-msgWaveformOutInactive: #b3e2b4;
-msgWaveformOutInactiveSelected: #91c3c3;
+msgWaveformInActive: windowBgActive; // inbox voice message active waveform lines (like played part of currently playing voice message)
+msgWaveformInActiveSelected: #51a3d3; // inbox selected voice message active waveform lines (like played part of currently playing voice message)
+msgWaveformInInactive: #d4dee6; // inbox voice message inactive waveform lines (like upcoming part of currently playing voice message)
+msgWaveformInInactiveSelected: #9cc1e1; // inbox selected voice message inactive waveform lines (like upcoming part of currently playing voice message)
+msgWaveformOutActive: #78c67f; // outbox voice message active waveform lines (like played part of currently playing voice message)
+msgWaveformOutActiveSelected: #6badad; // outbox selected voice message active waveform lines (like played part of currently playing voice message)
+msgWaveformOutInactive: #b3e2b4; // outbox voice message inactive waveform lines (like upcoming part of currently playing voice message)
+msgWaveformOutInactiveSelected: #91c3c3; // outbox selected voice message inactive waveform lines (like upcoming part of currently playing voice message)
 
-msgBotKbOverBgAdd: #ffffff20;
-msgBotKbIconFg: msgServiceFg;
-msgBotKbRippleBg: #00000020;
+msgBotKbOverBgAdd: #ffffff20; // this is painted over a bot inline keyboard button (which has msgServiceBg background) when mouse is over that button
+msgBotKbIconFg: msgServiceFg; // bot inline keyboard button icon in the top-right corner (like in @vote bot when a poll is ready to be shared)
+msgBotKbRippleBg: #00000020; // bot inline keyboard button ripple effect
 
-mediaInFg: msgInDateFg;
-mediaInFgSelected: msgInDateFgSelected;
-mediaOutFg: msgOutDateFg;
-mediaOutFgSelected: msgOutDateFgSelected;
+mediaInFg: msgInDateFg; // inbox media message status text (like in file that is being downloaded)
+mediaInFgSelected: msgInDateFgSelected; // inbox selected media message status text (like in file that is being downloaded)
+mediaOutFg: msgOutDateFg; // outbox media message status text (like in file that is being downloaded)
+mediaOutFgSelected: msgOutDateFgSelected; // outbox selected media message status text (like in file that is being downloaded)
 
-youtubePlayIconBg: #e83131c8;
-youtubePlayIconFg: windowFgActive;
-videoPlayIconBg: #0000007f;
-videoPlayIconFg: #ffffff;
-toastBg: #000000b2;
-toastFg: windowFgActive;
+youtubePlayIconBg: #e83131c8; // youtube play icon background (when a link to a youtube video with a webpage preview is sent)
+youtubePlayIconFg: windowFgActive; // youtube play icon arrow (when a link to a youtube video with a webpage preview is sent)
+videoPlayIconBg: #0000007f; // other video play icon background (like when a link to a vimeo video with a webpage preview is sent)
+videoPlayIconFg: #ffffff; // other video play icon arrow (like when a link to a vimeo video with a webpage preview is sent)
+toastBg: #000000b2; // toast notification background (like when you click on your t.me link when editing your username)
+toastFg: windowFgActive; // toast notification text (like when you click on your t.me link when editing your username)
 
-reportSpamBg: emojiPanHeaderBg;
-reportSpamFg: windowFg;
+reportSpamBg: emojiPanHeaderBg; // report spam panel background (like a non contact user writes your for the first time)
+reportSpamFg: windowFg; // report spam panel text (when you send a report from that panel)
 
-historyToDownBg: windowBg;
-historyToDownBgOver: windowBgOver;
-historyToDownBgRipple: windowBgRipple;
-historyToDownFg: menuIconFg;
-historyToDownFgOver: menuIconFgOver;
-historyToDownShadow: #00000040;
+historyToDownBg: windowBg; // arrow button background (to scroll to the end of the viewed chat)
+historyToDownBgOver: windowBgOver; // arrow button background with mouse over
+historyToDownBgRipple: windowBgRipple; // arrow button ripple effect
+historyToDownFg: menuIconFg; // arrow button icon
+historyToDownFgOver: menuIconFgOver; // arrow button icon with mouse over
+historyToDownShadow: #00000040; // arrow button shadow
 
-historyComposeAreaBg: msgInBg;
-historyComposeAreaFg: historyTextInFg;
-historyComposeAreaFgService: msgInDateFg;
-historyComposeIconFg: menuIconFg;
-historyComposeIconFgOver: menuIconFgOver;
-historySendIconFg: windowBgActive;
-historySendIconFgOver: windowBgActive;
-historyPinnedBg: historyComposeAreaBg;
-historyReplyBg: historyComposeAreaBg;
-historyReplyIconFg: windowBgActive;
-historyReplyCancelFg: cancelIconFg;
-historyReplyCancelFgOver: cancelIconFgOver;
+historyComposeAreaBg: msgInBg; // history compose area background (message write area / reply information / forwarding information)
+historyComposeAreaFg: historyTextInFg; // history compose area text
+historyComposeAreaFgService: msgInDateFg; // history compose area text when replying to a media message
+historyComposeIconFg: menuIconFg; // history compose area icon (like emoji, attach, bot command..)
+historyComposeIconFgOver: menuIconFgOver; // history compose area icon with mouse over
+historySendIconFg: windowBgActive; // send message icon
+historySendIconFgOver: windowBgActive; // send message icon with mouse over
+historyPinnedBg: historyComposeAreaBg; // pinned message area background
+historyReplyBg: historyComposeAreaBg; // reply / forward / edit message area background
+historyReplyIconFg: windowBgActive; // reply / forward / edit message left icon
+historyReplyCancelFg: cancelIconFg; // reply / forward / edit message cancel button
+historyReplyCancelFgOver: cancelIconFgOver; // reply / forward / edit message cancel button with mouse over
 
-historyComposeButtonBg: historyComposeAreaBg;
-historyComposeButtonBgOver: windowBgOver;
-historyComposeButtonBgRipple: windowBgRipple;
+historyComposeButtonBg: historyComposeAreaBg; // unblock / join channel / mute channel button background
+historyComposeButtonBgOver: windowBgOver; // unblock / join channel / mute channel button background with mouse over
+historyComposeButtonBgRipple: windowBgRipple; // unblock / join channel / mute channel button ripple effect
 
 // overview
-overviewCheckBg: #00000040;
-overviewCheckFg: windowBg;
-overviewCheckFgActive: windowBg;
-overviewPhotoSelectOverlay: #40ace333;
+overviewCheckBg: #00000040; // shared media / files / links checkbox background for not selected rows when some rows are selected
+overviewCheckBgActive: windowBgActive; // shared media / files / links checkbox background for selected rows
+overviewCheckBorder: windowBg; // shared media round checkbox border
+overviewCheckFg: windowBg; // shared files / links checkbox icon for not selected rows when some rows are selected
+overviewCheckFgActive: windowBg; // shared files / links checkbox icon for selected rows
+overviewPhotoSelectOverlay: #40ace333; // shared photos / videos / links fill for selected rows
 
 // profile
-profileStatusFgOver: #7c99b2;
-profileVerifiedCheckBg: windowBgActive;
-profileVerifiedCheckFg: windowFgActive;
-profileAdminStartFg: windowBgActive;
+profileStatusFgOver: #7c99b2; // group members list in group profile user last seen text with mouse over
+profileVerifiedCheckBg: windowBgActive; // profile verified check icon background
+profileVerifiedCheckFg: windowFgActive; // profile verified check icon tick
+profileAdminStartFg: windowBgActive; // group members list creator star icon
+profileAdminStarFgOver: profileAdminStartFg; // group members list creator star icon with mouse over
+profileOtherAdminStarFg: windowSubTextFg; // group members list admin star icon
+profileOtherAdminStarFgOver: profileStatusFgOver; // group members list admin star icon with mouse over
 
 // settings
-notificationsBoxMonitorFg: windowFg;
-notificationsBoxScreenBg: dialogsBgActive; // #6389a8;
+notificationsBoxMonitorFg: windowFg; // custom notifications settings box monitor color
+notificationsBoxScreenBg: dialogsBgActive; // #6389a8; // custom notifications settings box monitor screen background
 
-notificationSampleUserpicFg: windowBgActive;
-notificationSampleCloseFg: #d7d7d7 | windowSubTextFg;
-notificationSampleTextFg: #d7d7d7 | windowSubTextFg;
-notificationSampleNameFg: #939393 | windowSubTextFg;
+notificationSampleUserpicFg: windowBgActive; // custom notifications settings box small sample userpic placeholder
+notificationSampleCloseFg: #d7d7d7 | windowSubTextFg; // custom notifications settings box small sample close button placeholder
+notificationSampleTextFg: #d7d7d7 | windowSubTextFg; // custom notifications settings box small sample text placeholder
+notificationSampleNameFg: #939393 | windowSubTextFg; // custom notifications settings box small sample name placeholder
 
-mainMenuBg: windowBg;
-mainMenuCoverBg: dialogsBgActive;
-mainMenuCoverFg: windowFgActive;
+changePhoneSimcardFrom: notificationSampleTextFg; // change phone number box left simcard icon
+changePhoneSimcardTo: notificationSampleNameFg; // change phone number box right simcard and plane icons
 
-mediaPlayerBg: windowBg;
-mediaPlayerActiveFg: windowBgActive;
-mediaPlayerInactiveFg: sliderBgInactive;
-mediaPlayerDisabledFg: #9dd1ef;
+mainMenuBg: windowBg; // main menu background
+mainMenuCoverBg: dialogsBgActive; // main menu top cover background
+mainMenuCoverFg: windowFgActive; // main menu top cover text
+mainMenuCloudFg: activeButtonFg;
+mainMenuCloudBg: #2785bf | activeButtonBgRipple;
+
+mediaPlayerBg: windowBg; // audio file player background
+mediaPlayerActiveFg: windowBgActive; // audio file player playback progress already played part
+mediaPlayerInactiveFg: sliderBgInactive; // audio file player playback progress upcoming (not played yet) part with mouse over
+mediaPlayerDisabledFg: #9dd1ef; // audio file player loading progress (when you're playing an audio file and switch to the previous one which is not loaded yet)
 
 // mediaview
-mediaviewFileBg: windowBg;
-mediaviewFileNameFg: windowFg;
-mediaviewFileSizeFg: windowSubTextFg;
-mediaviewFileRedCornerFg: #d55959;
-mediaviewFileYellowCornerFg: #e8a659;
-mediaviewFileGreenCornerFg: #49a957;
-mediaviewFileBlueCornerFg: #599dcf;
-mediaviewFileExtFg: activeButtonFg;
+mediaviewFileBg: windowBg; // file rectangle background (when you view a png file in Media Viewer and go to a previous, not loaded yet, file)
+mediaviewFileNameFg: windowFg; // file name in file rectangle
+mediaviewFileSizeFg: windowSubTextFg; // file size text in file rectangle
+mediaviewFileRedCornerFg: #d55959; // red file thumbnail placeholder corner in file rectangle (for a file without thumbnail, like .pdf)
+mediaviewFileYellowCornerFg: #e8a659; // yellow file thumbnail placeholder corner in file rectangle (for a file without thumbnail, like .zip)
+mediaviewFileGreenCornerFg: #49a957; // green file thumbnail placeholder corner in file rectangle (for a file without thumbnail, like .exe)
+mediaviewFileBlueCornerFg: #599dcf; // blue file thumbnail placeholder corner in file rectangle (for a file without thumbnail, like .dmg)
+mediaviewFileExtFg: activeButtonFg; // file extension text in file thumbnail placeholder in file rectangle
 
-mediaviewMenuBg: #383838;
-mediaviewMenuBgOver: #505050;
-mediaviewMenuBgRipple: #676767;
-mediaviewMenuFg: windowFgActive;
+mediaviewMenuBg: #383838; // context menu in Media Viewer background
+mediaviewMenuBgOver: #505050; // context menu item background with mouse over
+mediaviewMenuBgRipple: #676767; // context menu item ripple effect
+mediaviewMenuFg: windowFgActive; // context menu item text
 
-mediaviewBg: #222222eb;
-mediaviewVideoBg: imageBg;
-mediaviewControlBg: #0000003c;
-mediaviewControlFg: windowFgActive;
-mediaviewCaptionBg: #11111180;
-mediaviewCaptionFg: mediaviewControlFg;
-mediaviewTextLinkFg: #91d9ff;
-mediaviewSaveMsgBg: toastBg;
-mediaviewSaveMsgFg: toastFg;
+mediaviewBg: #222222eb; // Media Viewer background
+mediaviewVideoBg: imageBg; // Media Viewer background when viewing a video in full screen
+mediaviewControlBg: #0000003c; // controls background (like next photo / previous photo)
+mediaviewControlFg: windowFgActive; // controls icon (like next photo / previous photo)
+mediaviewCaptionBg: #11111180; // caption text background (when viewing photo with caption)
+mediaviewCaptionFg: mediaviewControlFg; // caption text
+mediaviewTextLinkFg: #91d9ff; // caption text link
+mediaviewSaveMsgBg: toastBg; // save to file toast message background in Media Viewer
+mediaviewSaveMsgFg: toastFg; // save to file toast message text
 
-mediaviewPlaybackActive: #c7c7c7;
-mediaviewPlaybackInactive: #252525;
-mediaviewPlaybackActiveOver: #ffffff;
-mediaviewPlaybackInactiveOver: #474747;
-mediaviewPlaybackProgressFg: #ffffffc7;
-mediaviewPlaybackIconFg: mediaviewPlaybackActive;
-mediaviewPlaybackIconFgOver: mediaviewPlaybackActiveOver;
-mediaviewTransparentBg: #ffffff;
-mediaviewTransparentFg: #cccccc;
+mediaviewPlaybackActive: #c7c7c7; // video playback progress already played part
+mediaviewPlaybackInactive: #252525; // video playback progress upcoming (not played yet) part
+mediaviewPlaybackActiveOver: #ffffff; // video playback progress already played part with mouse over
+mediaviewPlaybackInactiveOver: #474747; // video playback progress upcoming (not played yet) part with mouse over
+mediaviewPlaybackProgressFg: #ffffffc7; // video playback progress text
+mediaviewPlaybackIconFg: mediaviewPlaybackActive; // video playback controls icon
+mediaviewPlaybackIconFgOver: mediaviewPlaybackActiveOver; // video playback controls icon with mouse over
+mediaviewTransparentBg: #ffffff; // transparent filling part (when viewing a transparent .png file in Media Viewer)
+mediaviewTransparentFg: #cccccc; // another transparent filling part
 
 // notification
-notificationBg: windowBg;
+notificationBg: windowBg; // custom notification window background
+
+// calls
+callBg: #26282cf2; // phone call popup background
+callNameFg: #ffffff; // phone call popup name text
+callFingerprintBg: #00000066; // phone call popup emoji fingerprint background
+callStatusFg: #aaabac; // phone call popup status text
+callIconFg: #ffffff; // phone call popup answer, hangup and mute mic icon
+callAnswerBg: #64c15b; // phone call popup answer button background
+callAnswerRipple: #52b149; // phone call popup answer button ripple effect
+callAnswerBgOuter: #50eb4126; // phone call popup answer button outer ripple effect
+callHangupBg: #d75a5a; // phone call popup hangup button background
+callHangupRipple: #c04646; // phone call popup hangup button ripple effect
+callCancelBg: #ffffff; // phone call popup line busy cancel button background
+callCancelFg: #777777; // phone call popup line busy cancel button icon
+callCancelRipple: #f1f1f1; // phone call popup line busy cancel button ripple effect
+callMuteRipple: #ffffff12; // phone call popup mute mic ripple effect
+
+callBarBg: dialogsBgActive; // active phone call bar background
+callBarMuteRipple: dialogsRippleBgActive; // active phone call bar mute and hangup button ripple effect
+callBarBgMuted: #8f8f8f | dialogsUnreadBgMuted; // phone call bar with muted mic background
+callBarUnmuteRipple: #7f7f7f | shadowFg; // phone call bar with muted mic mute and hangup button ripple effect
+callBarFg: dialogsNameFgActive; // phone call bar text and icons
+
+importantTooltipBg: toastBg;
+importantTooltipFg: toastFg;
+importantTooltipFgLink: mediaviewTextLinkFg;

Telegram/Resources/default.tdesktop-theme

@@ -1,415 +0,0 @@
-//
-// This is a sample Telegram Desktop theme file.
-// It was generated from the 'colors.palette' style file.
-//
-// To create a theme with a background image included you should
-// put two files in a .zip archive:
-//
-// First one is the color scheme like the one you're viewing
-// right now, this file should be named 'colors.tdesktop-theme'.
-//
-// Second one should be the background image and it can be named
-// 'background.jpg', 'background.png', 'tiled.jpg' or 'tiled.png'.
-// You should name it 'background' (if you'd like it not to be tiled),
-// or it can be named 'tiled' (if you'd like it to be tiled).
-//
-// After that you need to change the extension of your .zip archive
-// to 'tdesktop-theme', so you'll have:
-//
-// mytheme.tdesktop-theme
-// |-colors.tdesktop-theme
-// |-background.jpg (or tiled.jpg, background.png, tiled.png)
-//
-
-windowBg: #ffffff;
-windowFg: #000000;
-windowBgOver: #f1f1f1;
-windowBgRipple: #e5e5e5;
-windowFgOver: windowFg;
-windowSubTextFg: #999999;
-windowSubTextFgOver: #919191;
-windowBoldFg: #222222;
-windowBoldFgOver: #222222;
-windowBgActive: #40a7e3;
-windowFgActive: #ffffff;
-windowActiveTextFg: #168acd;
-windowShadowFg: #000000;
-windowShadowFgFallback: #f1f1f1;
-shadowFg: #00000018;
-slideFadeOutBg: #0000003c;
-slideFadeOutShadowFg: windowShadowFg;
-imageBg: #000000;
-imageBgTransparent: #ffffff;
-activeButtonBg: windowBgActive;
-activeButtonBgOver: #39a5db;
-activeButtonBgRipple: #2095d0;
-activeButtonFg: windowFgActive;
-activeButtonFgOver: activeButtonFg;
-activeButtonSecondaryFg: #cceeff;
-activeButtonSecondaryFgOver: activeButtonSecondaryFg;
-activeLineFg: #37a1de;
-activeLineFgError: #e48383;
-lightButtonBg: windowBg;
-lightButtonBgOver: #e3f1fa;
-lightButtonBgRipple: #c9e4f6;
-lightButtonFg: windowActiveTextFg;
-lightButtonFgOver: lightButtonFg;
-attentionButtonFg: #d14e4e;
-attentionButtonFgOver: #d14e4e;
-attentionButtonBgOver: #fcdfde;
-attentionButtonBgRipple: #f4c3c2;
-outlineButtonBg: windowBg;
-outlineButtonBgOver: lightButtonBgOver;
-outlineButtonOutlineFg: windowBgActive;
-outlineButtonBgRipple: lightButtonBgRipple;
-menuBg: windowBg;
-menuBgOver: windowBgOver;
-menuBgRipple: windowBgRipple;
-menuIconFg: #a8a8a8;
-menuIconFgOver: #999999;
-menuSubmenuArrowFg: #373737;
-menuFgDisabled: #cccccc;
-menuSeparatorFg: #f1f1f1;
-scrollBarBg: #00000053;
-scrollBarBgOver: #0000007a;
-scrollBg: #0000001a;
-scrollBgOver: #0000002c;
-smallCloseIconFg: #c7c7c7;
-smallCloseIconFgOver: #a3a3a3;
-radialFg: windowFgActive;
-radialBg: #00000056;
-placeholderFg: windowSubTextFg;
-placeholderFgActive: #aaaaaa;
-inputBorderFg: #e0e0e0;
-filterInputBorderFg: #54c3f3;
-filterInputInactiveBg: windowBgOver;
-checkboxFg: #b3b3b3;
-sliderBgInactive: #e1eaef;
-sliderBgActive: windowBgActive;
-tooltipBg: #eef2f5;
-tooltipFg: #5d6c80;
-tooltipBorderFg: #c9d1db;
-titleShadow: #00000003;
-titleBg: windowBgOver;
-titleBgActive: titleBg;
-titleButtonBg: titleBg;
-titleButtonFg: #ababab;
-titleButtonBgOver: #e5e5e5;
-titleButtonFgOver: #9a9a9a;
-titleButtonBgActive: titleButtonBg;
-titleButtonFgActive: titleButtonFg;
-titleButtonBgActiveOver: titleButtonBgOver;
-titleButtonFgActiveOver: titleButtonFgOver;
-titleButtonCloseBg: titleButtonBg;
-titleButtonCloseFg: titleButtonFg;
-titleButtonCloseBgOver: #e81123;
-titleButtonCloseFgOver: windowFgActive;
-titleButtonCloseBgActive: titleButtonCloseBg;
-titleButtonCloseFgActive: titleButtonCloseFg;
-titleButtonCloseBgActiveOver: titleButtonCloseBgOver;
-titleButtonCloseFgActiveOver: titleButtonCloseFgOver;
-titleFg: #acacac;
-titleFgActive: #3e3c3e;
-trayCounterBg: #f23c34;
-trayCounterBgMute: #888888;
-trayCounterFg: #ffffff;
-trayCounterBgMacInvert: #ffffff;
-trayCounterFgMacInvert: #ffffff01;
-layerBg: #0000007f;
-cancelIconFg: menuIconFg;
-cancelIconFgOver: menuIconFgOver;
-boxBg: windowBg;
-boxTextFg: windowFg;
-boxTextFgGood: #4ab44a;
-boxTextFgError: #d84d4d;
-boxTitleFg: #404040;
-boxSearchBg: boxBg;
-boxSearchCancelIconFg: cancelIconFg;
-boxSearchCancelIconFgOver: cancelIconFgOver;
-boxTitleAdditionalFg: #808080;
-boxTitleCloseFg: cancelIconFg;
-boxTitleCloseFgOver: cancelIconFgOver;
-membersAboutLimitFg: windowSubTextFgOver;
-contactsBg: windowBg;
-contactsBgOver: windowBgOver;
-contactsNameFg: boxTextFg;
-contactsStatusFg: windowSubTextFg;
-contactsStatusFgOver: windowSubTextFgOver;
-contactsStatusFgOnline: windowActiveTextFg;
-photoCropFadeBg: layerBg;
-photoCropPointFg: #ffffff7f;
-introBg: windowBg;
-introTitleFg: windowBoldFg;
-introDescriptionFg: windowSubTextFg;
-introErrorFg: windowSubTextFg;
-introCoverTopBg: #0f89d0;
-introCoverBottomBg: #39b0f0;
-introCoverIconsFg: #5ec6ff;
-introCoverPlaneTrace: #5ec6ff69;
-introCoverPlaneInner: #c6d8e8;
-introCoverPlaneOuter: #a1bed4;
-introCoverPlaneTop: #ffffff;
-dialogsMenuIconFg: menuIconFg;
-dialogsMenuIconFgOver: menuIconFgOver;
-dialogsBg: windowBg;
-dialogsNameFg: windowBoldFg;
-dialogsChatIconFg: dialogsNameFg;
-dialogsDateFg: windowSubTextFg;
-dialogsTextFg: windowSubTextFg;
-dialogsTextFgService: windowActiveTextFg;
-dialogsDraftFg: #dd4b39;
-dialogsVerifiedIconBg: windowBgActive;
-dialogsVerifiedIconFg: windowFgActive;
-dialogsSendingIconFg: #c1c1c1;
-dialogsSentIconFg: #5dc452;
-dialogsUnreadBg: windowBgActive;
-dialogsUnreadBgMuted: #bbbbbb;
-dialogsUnreadFg: windowFgActive;
-dialogsBgOver: windowBgOver;
-dialogsNameFgOver: windowBoldFgOver;
-dialogsChatIconFgOver: dialogsNameFgOver;
-dialogsDateFgOver: windowSubTextFgOver;
-dialogsTextFgOver: windowSubTextFgOver;
-dialogsTextFgServiceOver: dialogsTextFgService;
-dialogsDraftFgOver: dialogsDraftFg;
-dialogsVerifiedIconBgOver: dialogsVerifiedIconBg;
-dialogsVerifiedIconFgOver: dialogsVerifiedIconFg;
-dialogsSendingIconFgOver: dialogsSendingIconFg;
-dialogsSentIconFgOver: dialogsSentIconFg;
-dialogsUnreadBgOver: dialogsUnreadBg;
-dialogsUnreadBgMutedOver: dialogsUnreadBgMuted;
-dialogsUnreadFgOver: dialogsUnreadFg;
-dialogsBgActive: #419fd9;
-dialogsNameFgActive: windowFgActive;
-dialogsChatIconFgActive: dialogsNameFgActive;
-dialogsDateFgActive: windowFgActive;
-dialogsTextFgActive: windowFgActive;
-dialogsTextFgServiceActive: dialogsTextFgActive;
-dialogsDraftFgActive: #c6e1f7;
-dialogsVerifiedIconBgActive: dialogsTextFgActive;
-dialogsVerifiedIconFgActive: dialogsBgActive;
-dialogsSendingIconFgActive: #ffffff99;
-dialogsSentIconFgActive: dialogsTextFgActive;
-dialogsUnreadBgActive: dialogsTextFgActive;
-dialogsUnreadBgMutedActive: dialogsDraftFgActive;
-dialogsUnreadFgActive: dialogsBgActive;
-dialogsForwardBg: dialogsBgActive;
-dialogsForwardFg: dialogsNameFgActive;
-searchedBarBg: windowBgOver;
-searchedBarBorder: shadowFg;
-searchedBarFg: windowSubTextFgOver;
-topBarBg: windowBg;
-emojiPanBg: windowBg;
-emojiPanCategories: #f7f7f7; // windowBg;
-emojiPanHeaderFg: windowSubTextFg;
-emojiPanHeaderBg: #fffffff2; // emojiPanBg;
-stickerPanDeleteBg: #000000cc;
-stickerPanDeleteFg: windowFgActive;
-stickerPreviewBg: #ffffffb0;
-historyTextInFg: windowFg;
-historyTextOutFg: windowFg;
-historyCaptionInFg: historyTextInFg;
-historyCaptionOutFg: historyTextOutFg;
-historyFileNameInFg: historyTextInFg;
-historyFileNameOutFg: historyTextOutFg;
-historyOutIconFg: dialogsSentIconFg;
-historyOutIconFgSelected: #4da79f;
-historyIconFgInverted: windowFgActive;
-historySendingOutIconFg: #98d292;
-historySendingInIconFg: #a0adb5;
-historySendingInvertedIconFg: #ffffffc8;
-historySystemBg: #89a0b47f;
-historySystemBgSelected: #bbc8d4a2;
-historySystemFg: windowFgActive;
-historyUnreadBarBg: #fcfbfa;
-historyUnreadBarBorder: shadowFg;
-historyUnreadBarFg: #538bb4;
-historyForwardChooseBg: #0000004c;
-historyForwardChooseFg: windowFgActive;
-historyPeer1NameFg: #c03d33;
-historyPeer1UserpicBg: #e17076;
-historyPeer2NameFg: #4fad2d;
-historyPeer2UserpicBg: #7bc862;
-historyPeer3NameFg: #d09306;
-historyPeer3UserpicBg: #e5ca77;
-historyPeer4NameFg: windowActiveTextFg;
-historyPeer4UserpicBg: #65aadd;
-historyPeer5NameFg: #8544d6;
-historyPeer5UserpicBg: #a695e7;
-historyPeer6NameFg: #cd4073;
-historyPeer6UserpicBg: #ee7aae;
-historyPeer7NameFg: #2996ad;
-historyPeer7UserpicBg: #6ec9cb;
-historyPeer8NameFg: #ce671b;
-historyPeer8UserpicBg: #faa774;
-historyPeerUserpicFg: windowFgActive;
-historyScrollBarBg: #517c417a;
-historyScrollBarBgOver: #517c41bc;
-historyScrollBg: #517c414c;
-historyScrollBgOver: #517c416b;
-msgInBg: windowBg;
-msgInBgSelected: #c2dcf2;
-msgOutBg: #effdde;
-msgOutBgSelected: #b7dbdb;
-msgSelectOverlay: #358cd44c;
-msgStickerOverlay: #358cd47f;
-msgInServiceFg: windowActiveTextFg;
-msgInServiceFgSelected: windowActiveTextFg;
-msgOutServiceFg: #3a8e26;
-msgOutServiceFgSelected: #367570;
-msgInShadow: #748ea229;
-msgInShadowSelected: #548dbb29;
-msgOutShadow: #3ac34740;
-msgOutShadowSelected: #37a78e40;
-msgInDateFg: #a0acb6;
-msgInDateFgSelected: #6a9cc5;
-msgOutDateFg: #6cc264;
-msgOutDateFgSelected: #50a79c;
-msgServiceFg: windowFgActive;
-msgServiceBg: #517c417f;
-msgServiceBgSelected: #96b38ba2;
-msgInReplyBarColor: activeLineFg;
-msgInReplyBarSelColor: activeLineFg;
-msgOutReplyBarColor: historyOutIconFg;
-msgOutReplyBarSelColor: historyOutIconFgSelected;
-msgImgReplyBarColor: msgServiceFg;
-msgInMonoFg: #4e7391;
-msgOutMonoFg: #469165;
-msgDateImgFg: msgServiceFg;
-msgDateImgBg: #00000054;
-msgDateImgBgOver: #00000074;
-msgDateImgBgSelected: #1c4a7187;
-msgFileThumbLinkInFg: lightButtonFg;
-msgFileThumbLinkInFgSelected: lightButtonFgOver;
-msgFileThumbLinkOutFg: #5eba5b;
-msgFileThumbLinkOutFgSelected: #31a298;
-msgFileInBg: windowBgActive;
-msgFileInBgOver: #4eade3;
-msgFileInBgSelected: #51a3d3;
-msgFileOutBg: #78c67f;
-msgFileOutBgOver: #6bc272;
-msgFileOutBgSelected: #5fb389;
-msgFile1Bg: #72b1df;
-msgFile1BgDark: #5c9ece;
-msgFile1BgOver: #5294c4;
-msgFile1BgSelected: #5099d0;
-msgFile2Bg: #61b96e;
-msgFile2BgDark: #4da859;
-msgFile2BgOver: #44a050;
-msgFile2BgSelected: #46a07e;
-msgFile3Bg: #e47272;
-msgFile3BgDark: #cd5b5e;
-msgFile3BgOver: #c35154;
-msgFile3BgSelected: #9f6a82;
-msgFile4Bg: #efc274;
-msgFile4BgDark: #e6a561;
-msgFile4BgOver: #dc9c5a;
-msgFile4BgSelected: #b19d84;
-historyFileInIconFg: msgInBg;
-historyFileInIconFgSelected: msgInBgSelected;
-historyFileInRadialFg: historyFileInIconFg;
-historyFileInRadialFgSelected: historyFileInIconFgSelected;
-historyFileOutIconFg: msgOutBg;
-historyFileOutIconFgSelected: msgOutBgSelected;
-historyFileOutRadialFg: historyFileOutIconFg;
-historyFileOutRadialFgSelected: historyFileOutIconFgSelected;
-historyFileThumbIconFg: msgInBg;
-historyFileThumbIconFgSelected: msgInBgSelected;
-historyFileThumbRadialFg: historyFileThumbIconFg;
-historyFileThumbRadialFgSelected: historyFileThumbIconFgSelected;
-msgWaveformInActive: windowBgActive;
-msgWaveformInActiveSelected: #51a3d3;
-msgWaveformInInactive: #d4dee6;
-msgWaveformInInactiveSelected: #9cc1e1;
-msgWaveformOutActive: #78c67f;
-msgWaveformOutActiveSelected: #6badad;
-msgWaveformOutInactive: #b3e2b4;
-msgWaveformOutInactiveSelected: #91c3c3;
-msgBotKbOverBgAdd: #ffffff20;
-msgBotKbIconFg: msgServiceFg;
-msgBotKbRippleBg: #00000020;
-mediaInFg: msgInDateFg;
-mediaInFgSelected: msgInDateFgSelected;
-mediaOutFg: msgOutDateFg;
-mediaOutFgSelected: msgOutDateFgSelected;
-youtubePlayIconBg: #e83131c8;
-youtubePlayIconFg: windowFgActive;
-videoPlayIconBg: #0000007f;
-videoPlayIconFg: #ffffff;
-toastBg: #000000b2;
-toastFg: windowFgActive;
-reportSpamBg: emojiPanHeaderBg;
-reportSpamFg: windowFg;
-historyToDownBg: windowBg;
-historyToDownBgOver: windowBgOver;
-historyToDownBgRipple: windowBgRipple;
-historyToDownFg: menuIconFg;
-historyToDownFgOver: menuIconFgOver;
-historyToDownShadow: #00000040;
-historyComposeAreaBg: msgInBg;
-historyComposeAreaFg: historyTextInFg;
-historyComposeAreaFgService: msgInDateFg;
-historyComposeIconFg: menuIconFg;
-historyComposeIconFgOver: menuIconFgOver;
-historySendIconFg: windowBgActive;
-historySendIconFgOver: windowBgActive;
-historyPinnedBg: historyComposeAreaBg;
-historyReplyBg: historyComposeAreaBg;
-historyReplyIconFg: windowBgActive;
-historyReplyCancelFg: cancelIconFg;
-historyReplyCancelFgOver: cancelIconFgOver;
-historyComposeButtonBg: historyComposeAreaBg;
-historyComposeButtonBgOver: windowBgOver;
-historyComposeButtonBgRipple: windowBgRipple;
-overviewCheckBg: #00000040;
-overviewCheckFg: windowBg;
-overviewCheckFgActive: windowBg;
-overviewPhotoSelectOverlay: #40ace333;
-profileStatusFgOver: #7c99b2;
-profileVerifiedCheckBg: windowBgActive;
-profileVerifiedCheckFg: windowFgActive;
-profileAdminStartFg: windowBgActive;
-notificationsBoxMonitorFg: windowFg;
-notificationsBoxScreenBg: dialogsBgActive;
-notificationSampleUserpicFg: windowBgActive;
-notificationSampleCloseFg: #d7d7d7; // windowSubTextFg;
-notificationSampleTextFg: #d7d7d7; // windowSubTextFg;
-notificationSampleNameFg: #939393; // windowSubTextFg;
-mainMenuBg: windowBg;
-mainMenuCoverBg: dialogsBgActive;
-mainMenuCoverFg: windowFgActive;
-mediaPlayerBg: windowBg;
-mediaPlayerActiveFg: windowBgActive;
-mediaPlayerInactiveFg: sliderBgInactive;
-mediaPlayerDisabledFg: #9dd1ef;
-mediaviewFileBg: windowBg;
-mediaviewFileNameFg: windowFg;
-mediaviewFileSizeFg: windowSubTextFg;
-mediaviewFileRedCornerFg: #d55959;
-mediaviewFileYellowCornerFg: #e8a659;
-mediaviewFileGreenCornerFg: #49a957;
-mediaviewFileBlueCornerFg: #599dcf;
-mediaviewFileExtFg: activeButtonFg;
-mediaviewMenuBg: #383838;
-mediaviewMenuBgOver: #505050;
-mediaviewMenuBgRipple: #676767;
-mediaviewMenuFg: windowFgActive;
-mediaviewBg: #222222eb;
-mediaviewVideoBg: imageBg;
-mediaviewControlBg: #0000003c;
-mediaviewControlFg: windowFgActive;
-mediaviewCaptionBg: #11111180;
-mediaviewCaptionFg: mediaviewControlFg;
-mediaviewTextLinkFg: #91d9ff;
-mediaviewSaveMsgBg: toastBg;
-mediaviewSaveMsgFg: toastFg;
-mediaviewPlaybackActive: #c7c7c7;
-mediaviewPlaybackInactive: #252525;
-mediaviewPlaybackActiveOver: #ffffff;
-mediaviewPlaybackInactiveOver: #474747;
-mediaviewPlaybackProgressFg: #ffffffc7;
-mediaviewPlaybackIconFg: mediaviewPlaybackActive;
-mediaviewPlaybackIconFgOver: mediaviewPlaybackActiveOver;
-mediaviewTransparentBg: #ffffff;
-mediaviewTransparentFg: #cccccc;
-notificationBg: windowBg;