search

paper-plane-developers / paper-plane

Chat over Telegram on a modern and elegant client
GNU General Public License v3.0
974 stars 40 forks source link
gnome gtk gtk4 libadwaita rust tdlib telegram telegram-client

readme

Paper Plane
Paper Plane

Chat over Telegram on a modern and elegant client

Translation status CI status Packaging status Telegram group


Screenshot

Paper Plane is an alternative Telegram client. It uses libadwaita for its user interface and strives to meet the design principles of the GNOME desktop.

Paper Plane is still under development and not yet feature-complete. However, the following things are already working:

Installation Instructions

Packaging status

Paper Plane is an in-development project and it isn't considered stable software yet.

Also, the included API credentials in the Flathub release are still very new and untested. In some cases, your account may end up banned by Telegram (check the Telegram API Credentials section below).

You can avoid that by using a custom built version of Paper Plane with provided API credentials via meson options, like this AUR package which you may prefer using if you use Arch Linux. These API credentials are much older and thus the risk of getting banned is reduced.

Flathub Beta

But, if you still feel brave enough, you can install the latest release from Flathub Beta. To do this, you need to add the the Flathub Beta remote first

$ flatpak remote-add --if-not-exists flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo

Then you can install the application by issuing

$ flatpak install flathub-beta app.drey.PaperPlane

Paper Plane can be kept up to date by issuing flatpak's update command like

$ flatpak update

CI Build (Not Recommended)

You can also grab the latest CI build with test API credentials from here. Then you need to unzip the archive's content and install the application with the command flatpak install paper-plane.flatpak. Keep in mind that these test credentials are even more riskier than those from the Flathub release. Also, you need to manually keep it updated.

Telegram API Credentials

Telegram requires custom clients to set some credentials for using their API. Paper Plane doesn't provide official API credentials, so the packagers are expected to set their own credentials for distributing the app, obtainable at https://my.telegram.org/. However, Paper Plane includes the Telegram's test credentials by default, which are very limited, but usable (especially for development). However, it's known that Telegram sometimes decides to ban accounts that use such credentials (especially newer accounts). For that reason, it's suggested to use your own API credentials, which can be set by using meson options (see the Build Instructions section below).

Build Instructions

Gnome Builder

Using Gnome Builder is the easiest way to get the app built without even using the terminal: just clone the repository and press the big "Run" button at the top and it will automatically build all the required dependencies together with the app.

Meson

Prerequisites

The following packages are required to build Paper Plane:

Additionally, Paper Plane requires the following GStreamer plugins installed in your system to correctly show all media files:

Instructions

meson . _build -Dtg_api_id=ID -Dtg_api_hash=HASH
ninja -C _build
sudo ninja -C _build install

Contribution

Any type of participation is encouraged. If you want to translate, you can refer to our weblate project. But also design and art contributions are welcome. For this our design repository is the first place to go.

If you want to contribute code, please keep your commits in the style of conventional commits. The only difference we make is that we capitalize the actual description after the colon ":" at the beginning of the sentence.

Acknowledgment

The general code architecture was heavily inspired by Fractal.

Also, some logic is inspired by Telegram X, which helps to understand how to use some TDLib features correctly and to their fullest potential.