HomeFeatures
What a Telegram video player has to get right
Playing a file is the easy half. Here is the rest.
- TV, phone, desktop and web
- MKV, MP4, AVI, TS and subtitles
- v1.28.5, 11 Nov 2026
What it looks like
Nine screens, filled with demo content.
The demo videos are made up. Their artwork is cut from photos on Unsplash, credited by photographer.
What it does
Built for a remote, a thumb, and a mouse and keyboard.
Watching
-
Starts in seconds and seeks properly. Skipping ahead re-aims the download.
-
Plays real-world files. MKV, MP4, AVI and TS, with subtitles and audio tracks.
-
Remembers where you stopped, with a Continue watching row on launch.
-
Finds subtitles online. Search OpenSubtitles or, for Malayalam, MSone from the player, then shift the subtitles or sound to match.
-
Casts to a Chromecast or Google TV from a phone or a computer, which keeps the controls. MKV plays, audio tracks switch on the TV, and your place comes back with you.
-
Casts to DLNA TVs and speakers from a phone or a computer, next to Chromecast. They show in the same Cast list on your Wi-Fi, and the controls stay on your device.
-
Takes a lighter copy on a slow line. Telegram's own 720p or 480p copy of a big video, picked for you on a slow line, or by you.
-
Does more than play and pause. Chapters, picture shapes from 4:3 to 21:9, Night mode, Even out volume and 3D for anaglyph glasses or a headset, in a More options panel.
-
Draws subtitles your way. Colour, edge, typeface, weight and the darkness of the box behind them, the same height on every video.
-
Light on storage. Playing a video keeps only that one, so an 8 GB stick is enough.
-
Saves the ones you choose. Downloads stay until you remove them, or go once watched.
-
Chooses where downloads are saved on Android: internal storage, an SD card or USB drive, or a folder you pick, with the free space of each shown.
-
Skips intros and credits. Remembers each series' speed and your audio and subtitle languages.
-
Helps with lectures too. Bookmarks with notes, A-B repeat, silence skipping and a short rewind on resume.
-
Is a phone app on a phone. The same library, drawn for the hand.
Browsing
-
Opens on a Home made from your chats. A carousel with title logos, ratings and an overview, then Continue watching, Recently added and a row for each starred chat. Pick the rows, open See all, or remove a video from history.
-
Searches every chat at once. One result per video, with filters, and a person, group or channel found by @username.
-
Puts shows in order. Each series gets a page by season, with Watch later, and a season or the whole show can be marked as watched.
-
Search by voice with your remote's microphone, and star chats to keep them one press away.
-
Shows media, not messages. Chats filter down to playable videos, including videos sent as files.
-
Shows up on the TV's home screen. New videos from starred chats show as a row on the Android TV home screen.
-
Tidies a busy chat. Forum topics become tabs, a video posted more than once is one poster where you pick the copy, and .part001 pieces play as one.
-
Opens t.me links. A post plays from its start time, and a chat or an invite shows before you join. On Android pick TMPlayer when asked, or paste a link into Search.
-
Keeps track for you. Watch later, new episodes, whole seasons at once, and how far through a course you are.
-
Adds posters and overviews, unless you switch them off. From TMDB, TVmaze and AniList, by the video's cleaned-up title only.
-
Understands episode filenames. The next one starts after a countdown you can stop.
-
Forgives how you type. Typos, missing accents and one wrong word still find the video.
Connecting and your devices
-
Gets through where Telegram is blocked. An MTProto, SOCKS5 or HTTP proxy, or a t.me/proxy link, before sign in or from Settings. Sign in with an email code works too.
-
Picks up on your other devices. Turn it on and your places are kept in one message in your own Saved Messages, where your other devices read them.
-
Tells you what is new. New episodes, new videos in starred chats, finished downloads, low storage and updates, each with its own switch.
-
Looks the way you like. An accent colour, Pure black for OLED screens, high contrast and a choice of typeface, with a live preview.
-
Keeps the device's space in check. What TMPlayer uses and what is free in one review, Free up space that asks first, and Save to a folder or the gallery.
-
Shows where you are signed in. See where TMPlayer is signed in and end those sessions, without signing out Telegram's own apps.
-
Keeps the list to what you watch. Hide a chat from TMPlayer, and one Sort and filter menu in every chat.
-
Locks, backs up and scales. An app PIN, a kids lock, a backup file and an interface size.
-
Updates itself from GitHub on Android, Windows and Linux. On a Mac it opens the release page.
Star it if it helped
Every feature here started as someone's request. A star keeps that going.
stars forks
Star on GitHubA closer look
Five screens, numbered to match the notes.
The player: watching while it downloads
It plays while it downloads, and the controls show how far the download has got.
- The lighter part of the timebar has downloaded. Seek past it and the download follows.
- Subtitles, audio track, speed and picture shape, each one click away.
- Volume, the mini player in the corner, and fullscreen.
Browsing a chat on Windows, macOS and Linux
Every video as a poster, with a floating bar for search, sorting and size.
- The chat you are in, with the way back to your chats beside it.
- A badge with the resolution, or New on something posted recently.
- Each poster gives the year, the size or number of copies, and the resolution.
- Search the chat, star it, sort, switch to rows or change the poster size from the bar.
Made for a remote on Android TV
Big cards you can read across a room, and a clear outline on whatever has focus.
- A bar along the top for Search, Home, Chats and Settings, with Favourites, History, Watch later and Downloads under your profile.
- Show recent chats, every chat, or only unread chats, channels, groups or people.
- Search by voice with your remote's microphone.
- Hold OK on a chat for its options, and star the ones you open most.
On the TV's home screen
A row of TMPlayer cards on the Android TV home screen. Switch it off in Settings.
- What was recently added to your starred chats, in a row under TMPlayer's name.
- The card in focus shows its title, running time and chat. OK plays it, or opens a show's page.
- Videos and shows wear their posters when online lookups are on; other videos show their own thumbnail.
Settings, a few short pages
Changes save as you make them, and each page is a short list.
- Autoplay of the next episode, sound, thumbnails while you seek, and how the controls behave.
- Subtitle size, a box behind them or none, and where they sit.
- Which videos show, such as hiding clips under a size you pick, and what opens first.
On Windows, macOS and Linux
The same account and library, in a window built for mouse and keyboard.
The window
- Signs in with the same QR code, or with a phone number.
- A sidebar and a grid. Home, History, Favourites, Downloads, your chats and Settings, with posters you can resize.
- Right click a video to play, restart, download or copy its Telegram link.
- Downloads are files in a folder you can see, your Downloads folder unless you pick another drive, and stay until you remove them. Played videos are cached up to a limit you set.
- Remembers its window size and position. A second launch brings it forward.
The player
- Played through mpv: MKV, MP4, AVI, TS, image subtitles, DTS, TrueHD and E-AC3, all bundled.
- Streams while it downloads and seeks without waiting.
- Picks up where you stopped, offers the next episode, and remembers subtitle and audio choices per series.
- Keeps the screen awake while a video plays.
- Answers the media keys, the Linux desktop's media controls, and the media flyout on Windows.
All about the desktop app: installing, signing in, updates and the computers it runs on.
Desktop keyboard shortcuts
YouTube's keys, plus mpv's and VLC's. None fire while you type.
| To do this | Press |
|---|---|
| Play or pause | Space K, or click the picture |
| Back or forward 5 seconds | ← → |
| Back or forward 10 seconds | J L, or Shift with the wheel |
| Back or forward a minute | Shift+← Shift+→ |
| Back or forward 5 minutes | Ctrl+Alt+← Ctrl+Alt+→ |
| One frame back or forward, paused | , . |
| Jump to a tenth of the way, 5 is half | 0 to 9, Home End |
| Volume | ↑ ↓, or the wheel |
| Mute | M |
| Fullscreen | F F11 Alt+Enter, or double click; Esc leaves it |
| Next or previous subtitles, on or off | V Shift+V C |
| Next or previous audio track | A Shift+A |
| Faster, slower, normal speed | ] [ Backspace |
| Next or previous episode | Shift+N Shift+P, Page Down Page Up |
| Always on top | Ctrl+T |
| Mini player in the corner, and back | Ctrl+P |
| Every shortcut | ? |
| Playback details | I |
| Back to the grid | Esc Backspace, or the mouse's back button |
| Quit | Ctrl+Q |
Right click the picture for audio, subtitles, speed and more. In the grid, / or Ctrl+F searches and Ctrl+, opens Settings.
Support TMPlayer
TMPlayer has no ads of our own (Telegram's sponsored messages appear in public channels, as Telegram requires) and no paid tier. If it saves you some bother, a coffee or a monthly sponsorship pays for the time that goes into it. It is voluntary and unlocks nothing: every feature is free for everyone.
No ads of our own and no paid tier. A coffee pays for the time that goes into it.