tgt
A terminal user interface (TUI) client for Telegram, written in Rust.
What is tgt?
tgt is a terminal user interface (TUI) client for Telegram, written in Rust. It provides a full-featured messaging experience directly in the terminal, allowing users to navigate chats, send messages, view media, and play voice notes without leaving the command-line environment. It solves the need for a lightweight, keyboard-driven alternative to graphical desktop applications, especially useful for remote server use or terminal-centric workflows.
Developers, system administrators, and power users who primarily work in the terminal, prefer keyboard-driven interfaces, or need to access Telegram on remote servers without a graphical desktop. It is also suitable for users seeking a minimal, configurable messaging client.
Developers choose tgt for its native terminal integration, offering a consistent experience across Linux, macOS, and Windows with features like image rendering and voice message playback. Its customizable configuration, XDG-style paths, and multiple installation options (Cargo, Docker, AUR, NixOS) provide flexibility and control not always available in graphical clients.
Overview
TUI for Telegram written in Rust 🦀
Use Cases
Best For
- Accessing Telegram on remote servers or headless environments where graphical interfaces are unavailable.
- Users who prefer keyboard-driven, terminal-based applications for messaging to minimize context switching.
- Developers seeking a lightweight, configurable Telegram client with support for voice message playback and image previews in the terminal.
- System administrators needing a scriptable or containerized Telegram client for notifications or automation via Docker.
- NixOS or Arch Linux users looking for a packaged terminal messaging client integrated with their system's package manager.
- Power users who value customizable keybindings and XDG-compliant configuration management for their tools.
Not Ideal For
- Users requiring full multimedia support like video calls or high-resolution image viewing beyond terminal previews.
- Teams that rely on graphical interfaces for drag-and-drop file sharing or rich text formatting with emoji pickers.
- Environments with strict security constraints that avoid third-party dependencies like TDLib or external libraries.
Pros & Cons
Pros
Runs consistently on Linux, macOS, and Windows with CI workflows for each, providing a uniform messaging experience directly in any terminal environment.
Supports playing Telegram voice notes (OGG Opus) and displaying images via chafa library, enabling basic multimedia interaction without leaving the terminal.
Available through multiple methods including Cargo, Docker, AUR, and NixOS, catering to diverse system preferences and deployment scenarios as detailed in the README.
Features XDG-style config paths with automatic versioning and keybinding customization, ensuring user control and seamless upgrades with commands like 'tgt init-config'.
Cons
Requires external tools like CMake for voice message playback and system-installed chafa for image rendering, adding installation overhead and potential compatibility issues across platforms.
Image rendering relies on terminal graphics via chafa, which may not handle high-resolution images well and lacks support for video or advanced media types, restricting rich multimedia use.
As a first release, it may have undiscovered bugs or incomplete features, as noted in the README's warning about potential issues and suggestions for improvements.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.