TMPlayer

Your Telegram videos, on the TV, in your hand and on your computer. Start watching before the download finishes.

---

TMPlayer plays the videos in your own Telegram chats and channels on an Android TV, a phone, or a Windows or Linux computer. It starts within seconds while the file is still downloading, and seeking re-aims the download instead of waiting for it.

Sign in by scanning a QR code with your phone, pick a chat, and only its playable videos appear. No messages, no server, no account except yours.

Runs on

• Android 8.0 and up, TV and phone from the same APK. It was built and tested on an 8 GB TV stick with a gigabyte of RAM, so a cheap device is the target rather than an afterthought.
• Windows 10 and 11, 64-bit, as an MSI installer.
• Linux, 64-bit x86 with glibc 2.38 or newer, as an AppImage, with an AUR recipe in desktop/packaging/aur.

macOS is planned for later. Everything is on the same GitHub release, and tmplayer.org/download lists it by platform.

Install

Android TV and phones

Grab the universal APK from Releases. The same file works on every supported architecture, so there is no CPU variant to identify.

On the TV, turn on Developer options (Settings, About, press Build seven times), enable network debugging, then:

adb connect <tv-ip>:5555
adb install TMPlayer-<version>-universal.apk

Windows

Download TMPlayer-<version>-windows-x64.msi and open it. The build is not signed yet, so SmartScreen says Windows protected your PC: click More info, then Run anyway. It installs for your user only, with a Start menu entry and a desktop shortcut.

Linux

chmod +x TMPlayer-<version>-x86_64.AppImage
./TMPlayer-<version>-x86_64.AppImage

Arch: build from desktop/packaging/aur, or use the AppImage. The deb, rpm, Flatpak and Windows portable zip are no longer published; INSTALL.md says how to move over.

INSTALL.md has the full steps for every platform, how to put the app on the desktop, in the app menu and on the taskbar, the remote, touch and keyboard references, and troubleshooting.

Build it yourself

You need JDK 21, Android SDK platform 36, and your own free Telegram credentials from my.telegram.org in local.properties:

sdk.dir=/path/to/Android/Sdk
TG_API_ID=1234567
TG_API_HASH=your_api_hash

.env.example lists every optional value the build reads, what each one turns on, and how to set the same ones as repository secrets. All of them are optional: with none of them present the app builds, runs and carries none of this project's own endpoints, which is what a fork and every CI run get.

./gradlew test
./gradlew assembleDebug        # the Android app
./gradlew :desktop:run         # the desktop app, on the computer you are at

docs/BUILDING.md covers release builds, the desktop app and its installers, the reference test devices, and the version pins that are not free choices.

Read more

• Feature list: everything the app does, and what it deliberately does not.
• Install guide: sideloading, Windows and Linux, shortcuts, the remote and the keyboard, troubleshooting.
• Architecture: TDLib, the streaming DataSource, why it is built this way.
• Building and releasing.
• Contributing: ground rules, style, how to report an issue.
• Third-party notices: dependency licences and source locations.

Legal

Unofficial client. Not affiliated with, endorsed by, or connected to Telegram FZ-LLC. It uses the official Telegram API through TDLib with your own credentials, as permitted for third-party clients.

TMPlayer does not provide media, recommend channels, or bypass access controls. Use it only with content you own or are authorized to access. See the website's Privacy and Lawful use pages.

License

GNU GPL-3.0 © 2026 dracu-lah

Player mark via SVG Repo, recoloured.