kaffeine / kepka

Unofficial Telegram Desktop messaging app

Kepka - Unofficial Telegram Desktop fork from pro.cxx community

This is the complete source code and the build instructions for the Kepka's alpha version based on the Telegram API and the MTProto secure protocol.

Key features and differences from upstream Telegram

• CMake-only build (with a bit of Conan/vcpkg/your package manager. No GYP or patched libraries required);
• Do not require GTK for dialogs and notifications. Kepka will use native from Qt;
• Removed some Qt private stuff from dependencies;
• Kepka can be built and dynamically linked against official Qt packages;
• Added support of native system-wide font settings. Kepka will inherit DE's configuration;
• Partial refactoring and code cleanup;

• reduced #includes coupling (increases compile times and improves program design);
• removed broken PCHs (they are only increases compile times and transform #includes into one big katamari);
• remove some Qt and custom types in favor of using C++ Standard Library types and classes;
• clang-format;
• fix almost all warnings;
• optional inter-procedural optimizations on *nix (can be enabled by forwarding CMake's -DENABLE_IPO:BOOL=ON flag; improves performance but could significantly increase compilation times);
• optional packaged build for GNU/Linux maintainers (can be enabled by forwarding CMake's -DPACKAGED_BUILD:BOOL=ON flag; will disable automatic schema registration and icon generation);

• Ability to toggle "typographical" replaces (like replace << to « and another);
• Packages for Fedora and Arch Linux (packages for Debian and Ubuntu will be done soon);
• UI based on 1.1.21 before UI "mobilization" which degrades UX (e.g. group settings will be accessible from 5 clicks);
• Optional Yandex.Maps static API for geolocation preview (should be enabled at CMake configure time via -DKEPKA_OPTION_USE_YANDEX_MAPS=ON parameter);
• More features soon (see our milestones)!

Build instructions

Linux, macOS

What you need to have installed:

• Qt 5.9+ (with private modules, like qtbase5-private-dev)
• OpenSSL (conan installs this if you use conan)
• OpenAL-soft
• FFmpeg with swscale and swresample libs
• zlib
• opus (libopus-dev)

Debian/Ubuntu:

# apt-get install libssl-dev libavformat-dev libavdevice-dev libswscale-dev libavutil-dev libpulse-dev libasound2-dev libswresample-dev libavresample-dev libopus-dev qtbase5-private-dev zlib1g-dev libopenal-dev libavcodec-dev libopenal-data libopenal1

You most likely have to rebuild ffmpeg with --enable-swresample --enable-swscale

After that, go to the next section.

Fedora:

For more convenient work with building on Fedora, it's recommended to build it from our RPM spec file.

1. Installing and configuring RPM tools

# dnf install rpm-build rpmdevtools mock mock-rpmfusion-free

Add yourself to mock group (you must run this only for the first time after installing mock):

sudo usermod -a -G mock $(whoami)

You need to relogin to your system or run:

newgrp mock

Create RPM build base directories:

rpmdev-setuptree

2. Download sources:

spectool -g -R kepka.spec

3. Generate SRPM (Source RPM for building from sources):

rpmbuild -bs kepka.spec

4. Start mock build sequence:

mock -r fedora-$(rpm -E %fedora)-$(uname -m)-rpmfusion_free --rebuild ~/rpmbuild/SRPMS/kepka*.src.rpm

Configuring and building

Provide paths to OpenAL-soft and Qt5 in CMAKE_PREFIX_PATH variable when configuring.

ccache -o sloppiness=pch_defines,time_macros
mkdir _conan_build_
cd _conan_build_
conan install .. --build missing
cmake -G Ninja -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PREFIX_PATH="/usr/local/opt/qt5/;/usr/local/opt/openal-soft" ..
ninja

Windows

Install vcpkg (no need to integrate, just install), python 3.5, cmake, Qt 5.9 or later and Visual Studio 2017 or later, and set the following environment variables:

• QTDIR: directory where Qt binary distribution is installed, e.g. C:\Qt\5.9.1\msvc2017_64
• VCPKG: directory where VCPKG is installed, e.g. C:\vcpkg

After that, execute the following cmd commands from Visual Studio developer command prompt:

$ set PATH=c:\Python35;%PATH%
$ "%VCPKG%\vcpkg" install --triplet x64-windows openal-soft openssl opus zlib ffmpeg
$ mkdir build
$ cd build
$ set PATH=%QTDIR%\bin;%PATH%
$ cmake -G"Visual Studio 15 2017 Win64" -DCMAKE_TOOLCHAIN_FILE="%VCPKG%\scripts\buildsystems\vcpkg.cmake" -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
$ cmake --build . --config RelWithDebInfo

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

The Kepka logo is available by CC-BY-SA 4.0 License. (c) 2018 leha-bot. The full CC-BY-SA 4.0 license text is available here.

Supported systems

• Windows 7 - Windows 10 (not RT);
• Mac OS X 10.8 - Mac OS X 10.11 (not regularly tested);
• Mac OS X 10.6 - Mac OS X 10.7 (separate build, not tested);
• Ubuntu 12.04 - Ubuntu 16.04 (not regularly tested);
• Fedora 28 - Fedora 32 (old versions were retired).

Third-party

• CMake 3.10+
• Qt 5.9+ (LGPL)
• OpenSSL 1.0.1g (OpenSSL License)
• zlib 1.2.8 (zlib License)
• Ninja (Apache License 2.0)
• OpenAL Soft (LGPL)
• Opus codec (BSD License)
• FFmpeg (LGPL)
• Guideline Support Library (MIT License)
• Mapbox Variant (BSD License)
• Open Sans font (Apache License 2.0)
• Emoji alpha codes (MIT License)
• Catch test framework (Boost License)