GNU Emacs telegram client (unofficial)
No Data
See Telega Manual for comprehensive documentation.
This project is developed on two primary branches. The 'releases' branch is kept in compatibility with TDLib major releases. The 'master' branch is for developmental purposes, and utilizes unstable features in TDLib.
telega.elis full featured unofficial client for Telegram platform for GNU Emacs.
telega.elis actively developed, for this reason, some features are not implemented, or they are present just as skeleton for future implementation. However, the core parts are mature enough so that it is possible to use
telega.elfor basic chat.
In some random order:
M-x telega-chat-join-by-link RET
:syntax), usernames, hashtags, bot commands completions
ibuffer-like chats filtering
And much more.
Root buffer screen:
Chat in @emacs_en group:
Dashboard with Emacs Stories and important chats:
See Telega Manual for comprehensive documentation.
Join our Telegram group to discuss the development of
telega.el.
Submitting issues is exceptionally helpful.
telega.elis licensed under GNU GPL version 3.
Q: I have this error while installing telega
Cannot open load file: No such file or directory, visual-fill-column
A:
telega.eldepends on the
visual-fill-columnpackage, please install it first. This package is available from MELPA
Q: I have this error while running telega
(error "Invalid image type ‘svg’")
and/or
(error "Invalid image type ‘imagemagick’")
A: The appropriate behavior is adjusted based on what version of Emacs you use. If you are using 26.3 or older you need to ensure that your Emacs was configured with SVG and ImageMagick support. SVG support is provided using the
librsvglibrary, and ImageMagick is provided by
libmagickcoreand
libmagickwanddevelopment libraries.
If you are using Emacs 27.1+ the ImageMagick support was deprecated as it posed a significant security issue, but
teleganow relies on the in-built (and faster)
image-transformsfor those versions.
Q: Does telega have proxy support?
A: Yes, use
telega-proxiescustom variable, for example:
(setq telega-proxies (list '(:server "1.2.3.4" :port 8080 :enable :false :type (:@type "proxyTypeSocks5" :username "rkn" :password "jopa")) '(:server "2.3.4.5" :port 8088 :enable t :type (:@type "proxyTypeSocks5" :username "rkn" :password "jopa")) ))
See
C-h v telega-proxies RETfor full range of proxy types.
Q: Stickers are not shown.
A: If you are using Emacs 26.3 or older, ensure you it was configured with ImageMagick support. Next, install the
webppackage.
Q: There are no glyphs for some unicode characters.
A: Please either install
fonts-symbolapackage, or run
guix package -i font-gnu-{freefont,unifont}on GNU Guix
If using
fonts-symbola, add this to your init.el:
elisp (set-fontset-font t 'unicode "Symbola" nil 'append)
Q: There is some formatting issues when some unicode characters are used.
A: Yes, partly. If character has full width of multiple ordinary chars you can tweak
char-width-table. Add code like this to your init.el:
(setq telega-symbol-unread "🄌")(defun my-telega-load () ;; 🄌 occupies two full chars, but (string-width "🄌") returns 1 ;; so we install custom widths to `char-width-table' (telega-symbol-set-width telega-symbol-unread 2)
;; ... other code )
(add-hook 'telega-load-hook 'my-telega-load)
There is also
telega-symbol-widthscustom variable, you might want to modify it.
Q: Is there erc-like chats tracking functionality?
A: Yes, set
telega-use-tracking-forto non-nil
Tracking is done only for opened chats, i.e. chats having corresponding chat buffer.
Its value is a Chat Filter.
For example, to enable tracking for chats with enabled notifications or for chats where you have unread mention, use:
(setq telega-use-tracking-for '(or unmuted mention))
Q: Is it possible to use telega in tty-only Emacs (aka emacs-nox)?
A: Yes, set
telega-use-imagesto
nilbefore starting
telega
Q: Is it possible to add markup to messages?
A: Yes, use
C-u RETto send a message with markup
See Sending ordinary messages for details
You may also find
telega-mnz.elfrom the
contribdirectory to be complimentary.
Q: I've enabled
telega-notifications-mode, but notifications does not show
A: Make sure your time is correct
Eval
(telega-time-seconds)to get UTC time in your Emacs, it should be more or less the same as on https://www.unixtimestamp.com/