.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2017-2021 Nicholas Guriev <guriev-ns@ya.ru>

.TH TELEGRAM-DESKTOP 1 "2021-02-27"

.SH NAME
\fBtelegram\-desktop\fR \- fast and secure messaging application

.SH SYNOPSIS
.SY telegram-desktop
.OP \-autostart
.OP \-startintray
.OP \-debug
.OP \-scale INT
.OP \-workdir PATH
.OP \-\- URI
.YS

.SH DESCRIPTION
This manual page documents how to run \fBTelegram Desktop\fR, official Telegram
client.

.SH OPTIONS
Although the program is primarily a GUI application, it understands various
command line arguments, some of them are described in the present document.
.TP
.B \-autostart
Apply automatic start. It works if only auto-starting is allowed in settings and
the app is not locked by a passcode. Telegram will start minimized in the system
tray if the corresponding checkbox has been set.
.TP
.B \-startintray
Do not show the main window, just start in the system tray. Useful for automatic
unconditional launching.
.TP
.B \-debug
Run in debug mode immediately. See full logs in working directory or in standard
location at \fB~/\.local/share/TelegramDesktop/DebugLogs\fR.
.TP
.B \-scale INT
Set initial interface scale factor. Possible values are measured in percents
from 75 up to 300 inclusive.
.TP
.B \-workdir PATH
Change current working directory to specified path before start. All Telegram
data will be stored encrypted in this folder. You can pass this option to
partition different app instances that run simultaneously.
.TP
.I URI
Specify Telegram URI. It is used for automatically opening chats by
.B t.me
site.
.LP
There are also some other hidden options not intended for direct use.

.SH ENVIRONMENT
.TP
.B TDESKTOP_USE_PORTAL
Set this to something to make Telegram Desktop always use XDG Desktop portals to
open file dialogs. By default, the portal is used if available on KDE.
.TP
.B DESKTOP_APP_I_KNOW_ABOUT_GTK_INCOMPATIBILITY
Allows the app to load any Qt styles and platform themes. Telegram will not
clear global settings related to Qt. It is known this mode may cause a crash.
.TP
.B DESKTOP_APP_DISABLE_GTK_INTEGRATION
Do not initialize GTK by Telegram itself, leave that to a Qt platform plugin.
You may try to set this variable if the crash mentioned above happens.
.TP
.B XDG_DATA_HOME
Used to automatically determine working directory unless set by hand.
.TP
.B HOME
User home directory where the app stores downloaded files and configuration.

There is plenty of other environment variables that affect Telegram Desktop
behaviour and appearance.

.SH SEE ALSO
.UR https://github.com/telegramdesktop/tdesktop/wiki
Wiki on GitHub
.UE