TMPlayer: Open Source Media Streaming for Telegram Chats
A cross-platform media player enabling instant video playback from personal Telegram chats.
1Instant Streaming Architecture
TMPlayer functions as an unofficial media player designed to stream videos directly from personal Telegram chats. The core innovation lies in its ability to initiate playback while the file is still downloading. By re-aiming the download stream during seeking, the application eliminates the need to wait for complete file transfers before viewing.
2Cross-Platform Technical Scope
The project supports a wide range of hardware, including Android TV, Fire TV, and Android mobile devices. Desktop support covers Windows 10 and 11, Linux distributions requiring glibc 2.38, and Apple Silicon Macs. The build system leverages Gradle and requires JDK 21 alongside the Android SDK platform 37 for local compilation.
3Hardware Efficiency Targets
The application is specifically optimized for low-resource environments. Development and testing were conducted on an 8 GB TV stick equipped with only one gigabyte of RAM. This focus ensures that the player remains performant on budget-friendly hardware, avoiding the bloat often associated with modern media applications on limited streaming devices.
4Security and Privacy Model
TMPlayer operates without external servers, accounts, or data collection mechanisms. Users authenticate by scanning a QR code, ensuring that only their personal chat content is accessible. The application does not provide media recommendations or bypass access controls, strictly adhering to the permissions granted by the official Telegram API through TDLib.
5Installation and Deployment Methods
Deployment varies by platform, utilizing sideloading for Android TV and MSI installers for Windows. Linux users can deploy via AppImage, while macOS users receive a DMG package. The project provides detailed installation guides in the repository, including instructions for handling OS-specific security warnings like Windows SmartScreen or macOS system privacy settings.
6Developer-Centric Build Process
The repository is fully open source under the GNU GPL-3.0-or-later license. Developers can build the project by providing their own Telegram API credentials via local.properties files. The build configuration allows for optional feature toggles, ensuring that forks and CI runs remain independent of the project's own specific endpoints or infrastructure.
7Integration with Telegram Ecosystem
While the player is unofficial and unaffiliated with Telegram FZ-LLC, it utilizes the official TDLib library. It respects Telegram's requirements regarding sponsored messages in public channels. The architecture is documented in the repository, explaining the streaming DataSource implementation and the specific version pins required to maintain stability across different operating systems.
8Community and Future Support
The project maintains transparency through a public changelog and an RSS feed for release tracking. Support is managed via GitHub Discussions and a dedicated Telegram group for user feedback. As a non-commercial project, it relies on community contributions and GitHub sponsorships rather than paid tiers or internal advertising models for sustainability.
Original article: Hacker News: Show HN — TMPlayer: Open Source Media Streaming for Telegram Chats