TMPlayer plays the videos in your own Telegram chats and channels on an Android TV, a phone, or a
Windows, Mac 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 6.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.
- 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 Arch PKGBUILD in
desktop/packaging/aur.
- macOS 26 Tahoe or newer on Apple Silicon (M1 and later), as a DMG. It is not notarized by
Apple yet, and Intel Macs are not supported.
Everything is on the same GitHub release, and
tmplayer.org/download lists it by platform.
Install
Android TV and Google TV
With just the remote: install the free Downloader app from the Play Store, type
tmplayer.org/apk into it, press Go, and allow the install when the TV asks. On a Fire TV,
follow the Fire TV guide. A phone with Send files to TV, or adb
from a computer, work too; INSTALL.md has both.
Android phones
Open tmplayer.org/download on the phone, download the APK, open
it and allow the install. Obtainium can also install it
straight from the releases and keep it up to date:
Windows
Open PowerShell and paste:
irm https://tmplayer.org/install.ps1 | iex
It downloads the MSI from the release, checks it against the published SHA-256 and installs it for
your user, with no SmartScreen warning. Prefer an installer? Download
TMPlayer-<version>-windows-x64.msi and open it. It is not code signed yet, so SmartScreen says
Windows protected your PC: click More info, then Run anyway.
macOS
Download TMPlayer-<version>-macos-arm64.dmg, open it and drag TMPlayer onto
Applications. It is not notarized by Apple yet, so the first launch says "TMPlayer" Not
Opened: click Done, then Open Anyway in System Settings, Privacy and Security.
INSTALL.md has every step, and how updates work on a Mac.
Linux
chmod +x TMPlayer-<version>-x86_64.AppImage
./TMPlayer-<version>-x86_64.AppImage
Arch: build the PKGBUILD in desktop/packaging/aur (it is not on the 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 37, 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.
- Changelog: every release, with an RSS feed.
- Install guide: sideloading, Windows, macOS 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.
Community and support
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 Telegram account, 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-or-later © 2026 dracu-lah, with an additional permission for OpenSSL
(the Android app's TDLib links OpenSSL 1.1.1w). Bundled libraries and their sources:
THIRD_PARTY_NOTICES.md.
Player mark via SVG Repo, recoloured.
