VoIP

tg – Telegram terminal client

tg is a terminal Telegram client written in Python.

It presents chats and messages in a keyboard-driven interface designed for users who prefer working from a terminal. The client supports everyday messaging alongside media handling, voice messages, secret chats and desktop notifications. Configuration is a Python file, allowing users to change commands, colours, storage locations, external viewers and other behaviour.

This is free and unencumbered software released into the public domain.

Key Features

  • Send, reply to, edit, forward and delete messages, with support for selecting multiple messages.
  • View message history, list contacts and display user status and profile information.
  • Send pictures, documents, audio and video files directly from the terminal interface.
  • View photos, videos, voice and video notes, documents, stickers and other downloaded media.
  • Record and send voice messages, with ffmpeg available as an optional recording backend.
  • Supports secret chats and creation of new groups or secret conversations.
  • Pin or unpin chats, mark them read or unread, and mute or unmute conversations.
  • Vi-style keybindings with numeric movement commands, arrow-key navigation and extensive message controls.
  • Configurable external file pickers including ranger and nnn, with fzf integration for user selection.
  • Mailcap integration lets different external applications open images, video, audio, HTML and text files.
  • Desktop notifications can use dunst, terminal-notifier or another user-defined notification command.
  • Automatic media downloading with configurable cache retention and download directory.
  • Can use a custom TDLib library path and a configured local database encryption key.
  • Installable from PyPI, source, Docker or the Arch User Repository.

Website: github.com/paul-nameless/tg
Support:
Developer: Paul Nameless
License: The Unlicense

tg in action

tg is written in Python. Learn Python with our recommended free books and free tutorials.


Related Software

Terminal-Based Matrix Clients
GomuksTerminal Matrix client written in Go
iambMatrix client for Vim addicts
Ement.elMatrix client for Emacs
matrix-commanderSimple but convenient CLI-based Matrix client
matrix-commander-rsCommand-line Matrix client written in Rust
GōsutoLightweight terminal client for the Matrix communication protocol
mnotifySend notifications from a headless server

Read our verdict in the software roundup.


Best Free and Open Source Software Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.

This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk.

You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more.

Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form.
Subscribe

Please read our Comment Policy before commenting.

Notify of
guest
0 Comments
Oldest
Newest Most Voted