--- title: "TMPlayer: Telegram video player for Windows, Mac and Linux" description: "A free, unofficial Telegram video player for Windows, macOS and Linux. Sign in with a QR code and play the videos in your chats through mpv while they download." url: https://tmplayer.org/desktop/ --- # A Telegram video player *for Windows, Mac and Linux* TMPlayer is a free, open source and unofficial Telegram media player. On a computer it signs in to your own account, shows the videos in your chats as posters and plays them while they download. [Download](https://tmplayer.org/download/#windows) [How to install](https://tmplayer.org/install/#windows) ## The app on a computer The same account, library and streaming as the TV, in a window built for mouse and keyboard. ![The TMPlayer desktop app on Windows or Linux: a sidebar of sections beside a chat's demo films as posters, each with its year, size and resolution.](https://tmplayer.org/screenshots/desktop-grid.webp) **On a computer** A sidebar and a grid, built for a mouse and a keyboard. Click a poster and it plays. ![The TMPlayer desktop player over a demo video: the title and chat at the top, a timebar, and buttons for subtitles, audio, speed, picture shape, volume, the mini player and fullscreen.](https://tmplayer.org/screenshots/desktop-player.webp) **The desktop player** Played through mpv, with the keys YouTube uses and every subtitle and audio track one click away. It is built with Compose Multiplatform and plays through mpv, which comes inside the app: there is nothing else to install. ## What it does ### 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. ## Signing in and updates ### Sign in Sign in with Telegram's own Link Desktop Device flow. No bot, no server, nothing in between. Scan the QR code with Telegram on your phone: *Settings*, *Devices*, *Link Desktop Device*. Or choose *Log in by phone number*. ### Updates itself It looks for a new release when it starts and every six hours, and installs nothing until you press the button. On Windows the new MSI installs in place, on Linux the AppImage replaces itself, and on a Mac it opens the release page. Every download is checked against its SHA-256 first. ## Install it on your computer ### Windows Windows 10 or 11, 64-bit. No administrator password needed. ``` irm https://tmplayer.org/install.ps1 | iex ``` Paste this line into PowerShell: it downloads the MSI from GitHub, checks it against the published checksum and installs TMPlayer for your user. Or download the MSI and open it yourself. [Every step](https://tmplayer.org/install/#windows) ### macOS A preview for Macs with Apple Silicon (M1 and later) running macOS 26 Tahoe or newer. Intel Macs are not supported, and an older macOS will not open it. Drag it to Applications. It is not notarized by Apple yet, so the first time macOS says it was not opened: click *Done*, then *Open Anyway* in *System Settings*, *Privacy and Security*. [Every step](https://tmplayer.org/install/#macos) ### Linux x86_64, with glibc 2.38 or newer: Ubuntu 24.04, Debian 13, Fedora 39 and later One AppImage for any distribution: make it executable and open it. On Arch, build the PKGBUILD in the repository with `makepkg -si`. [Every step](https://tmplayer.org/install/#linux) ## Desktop keyboard shortcuts YouTube's keys, plus the ones mpv and VLC use. None of them fire while you type in search. | 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` | | Back or forward a minute | `Shift`+`←` `Shift`+`→` | | Volume | `↑` `↓`, or the wheel | | Mute | `M` | | Fullscreen | `F` `F11` | | Next or previous subtitles, on or off | `V` `Shift`+`V` `C` | | Next or previous audio track | `A` `Shift`+`A` | | Next or previous episode | `Shift`+`N` `Shift`+`P` | | Mini player in the corner, and back | `Ctrl`+`P` | On a Mac, Cmd takes the place of Ctrl. Press `?` in the player for all of them, or see [the full table](https://tmplayer.org/features/#keys). ## Will it run on yours? ### Yes - Windows 10 and 11, 64-bit - Macs with Apple Silicon on macOS 26 or newer, as a preview - Linux on 64-bit x86, any distribution with glibc 2.38 or newer ### No - No iPhone or iPad version. - Not Intel Macs, and not a macOS older than 26. - Not Linux on ARM, such as a Raspberry Pi: 64-bit x86 only for now. ## Star it if it helped A desktop app that grew out of a TV app. If it plays your Telegram videos well, a star tells the next person it is worth a try. [Star on GitHub](https://github.com/dracu-lah/TMPlayer) [Fork the repository](https://github.com/dracu-lah/TMPlayer/fork) GPL-3.0, and free for good ### 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. [Sponsor on GitHub](https://github.com/sponsors/dracu-lah) [Buy me a coffee](https://buymeacoffee.com/nevil.dev)