---
title: "How to install TMPlayer on Android TV, Windows, macOS, Linux"
description: "Install TMPlayer: Downloader and the remote on Android TV, the APK on a phone, one PowerShell line on Windows, the DMG on a Mac, the AppImage on Linux."
url: https://tmplayer.org/install/
---

# How to install it, *wherever you watch*

On a TV, a phone, Windows, a Mac or Linux. You only do it once.

[All downloads](https://tmplayer.org/download/) [The full INSTALL.md](https://github.com/dracu-lah/TMPlayer/blob/main/INSTALL.md)

## On Android TV or Google TV

Android TV 6.0 or newer, and only the remote. On a Fire TV, [follow the Fire TV guide](https://tmplayer.org/guides/telegram-videos-on-fire-tv/).

About five minutes, with only the remote.

1. ### Install Downloader

   On the TV, open the Play Store, search for *Downloader* and install the free app by AFTVnews.

2. ### Type this address into Downloader

   Open it and type the address in the box at the top, or just the code:

   ```
   tmplayer.org/apk
   ```

   or

   ```
   3206503
   ```

   The code works in the Downloader app only. In a browser, use the address.

   Press *Go*. The latest TMPlayer starts downloading straight away.

3. ### Allow the install

   When the TV asks, let Downloader install apps, then press *Install*. No switch to allow it? Open *Settings*, then *About* (under *Device Preferences* or *System*), press *Build* seven times and try again.

4. ### Sign in

   Open TMPlayer and scan the QR code with Telegram on your phone: *Settings*, *Devices*, *Link Desktop Device*.

   ![The sign-in screen on a television: a QR code to scan with Telegram on your phone, and the three steps beside it.](https://tmplayer.org/screenshots/tv-sign-in.webp)

### Other ways

### From a phone

Install [Send files to TV](https://play.google.com/store/apps/details?id=com.yablio.sendfilestotv) on the phone and on the TV, download the APK on the phone, then send it across.

### From a computer

Turn on *Network debugging* in the TV's Developer options and find the TV's IP address in its network settings. Then, on a computer on the same Wi-Fi, in the folder with the APK, run these with that address in place of `<tv-ip>`:

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

Accept the debugging prompt that appears on the television the first time.

## Star it if it helped

If these steps got your videos on screen, a star helps the next person.

[Star on GitHub](https://github.com/dracu-lah/TMPlayer)

## On an Android phone

Android 6.0 or newer. It takes a minute.

1. ### Download the APK

   On the phone, open [the download page](https://tmplayer.org/download/) and tap the download button at the top.

2. ### Open it and allow the install

   Open the file when it finishes. The first time, Android asks to let your browser install apps: allow it, then tap *Install*.

3. ### Sign in

   Open TMPlayer and enter your phone number. To sign in an account that lives on another phone, scan the QR code from that phone instead.

Or add it to [Obtainium](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/dracu-lah/TMPlayer), which installs it from GitHub and keeps it up to date.

## On Windows

Windows 10 or 11, 64-bit. No administrator password needed.

1. ### Open PowerShell

   Open *Start*, type *PowerShell* and press Enter. A normal window is fine; it does not need to run as administrator.

2. ### Paste this line and press Enter

   ```
   irm https://tmplayer.org/install.ps1 | iex
   ```

   Click the line to copy it, then paste it into PowerShell with Ctrl+V or a right click.

   It downloads the installer from GitHub, checks it against the published checksum and installs TMPlayer for your user, with no warning from Windows. It takes a minute or two. When it says TMPlayer is installed, close the window. If it stops with a red error instead, use [the installer](https://tmplayer.org/install/#windows-installer) below.

3. ### Open it and sign in

   TMPlayer is now in the Start menu and on the desktop.

   Scan the QR code with Telegram on your phone: *Settings*, *Devices*, *Link Desktop Device*. Or choose *Log in by phone number*.

### Prefer an installer?

Download `TMPlayer-<version>-windows-x64.msi` from [the download page](https://tmplayer.org/download/#windows) and open it. It is not code signed yet, so Windows may say *Windows protected your PC*: click *More info*, then *Run anyway*.

Used the old portable zip? Delete its folder and install as above. Your settings carry over.

## On macOS

For Apple Silicon Macs on macOS 26 Tahoe or newer. No Intel Macs.

1. ### Drag it to Applications

   Download `TMPlayer-<version>-macos-arm64.dmg` from [the download page](https://tmplayer.org/download/#macos), open it, and drag *TMPlayer* onto *Applications*.

2. ### Open it, then allow it once

   The app is not notarized by Apple yet, so the first time macOS says *"TMPlayer" Not Opened*. Click *Done*.

   Open *System Settings*, *Privacy and Security*, scroll down to *"TMPlayer" was blocked to protect your Mac* and click *Open Anyway*. Confirm with your password or Touch ID and click *Open Anyway* once more. macOS remembers this, so later launches open straight away.

   Or the same in Terminal:

   ```
   xattr -dr com.apple.quarantine /Applications/TMPlayer.app
   ```

3. ### Sign in

   Scan the QR code with Telegram on your phone: *Settings*, *Devices*, *Link Desktop Device*. Or choose *Log in by phone number*.

### Updates

TMPlayer tells you when a new version is out. Drag the new DMG over the old one: your sign-in, history and downloads stay.

Checked on Apple Silicon Macs with macOS 26. Reports are welcome on the [issues page](https://github.com/dracu-lah/TMPlayer/issues).

## On Linux

x86_64, with glibc 2.38 or newer: Ubuntu 24.04, Debian 13, Fedora 39 and later

1. ### Download the AppImage

   Take `TMPlayer-<version>-x86_64.AppImage` from [the download page](https://tmplayer.org/download/#linux). One file, for any distribution.

2. ### Make it executable and open it

   In a terminal, in the folder you saved it to:

   ```
   cd ~/Downloads
   chmod +x TMPlayer-<version>-x86_64.AppImage
   ./TMPlayer-<version>-x86_64.AppImage
   ```

   Or tick *Allow executing file as program* in the file's properties and double click it.

3. ### Sign in

   Scan the QR code with Telegram on your phone: *Settings*, *Devices*, *Link Desktop Device*. Or choose *Log in by phone number*.

### Other ways

### Arch Linux

Build the package from the recipe in [`desktop/packaging/aur`](https://github.com/dracu-lah/TMPlayer/tree/main/desktop/packaging/aur) with `makepkg -si`. It is not on the AUR: the `tmplayer` package there is a different app.

### The plain folder

Unpack `TMPlayer-<version>-linux-x64.tar.xz` anywhere and run `bin/TMPlayer` inside it. It does not update itself: TMPlayer tells you when a new version is out.

### Moving from the deb, rpm or Flatpak

These are no longer published. Remove the old one (`sudo apt remove tmplayer`, `sudo dnf remove tmplayer` or `flatpak uninstall io.github.dracu_lah.TMPlayer`) and take the AppImage. After the deb or rpm, your sign-in and settings carry over. The Flatpak kept them inside its sandbox, so [copy them out first](https://github.com/dracu-lah/TMPlayer/blob/main/INSTALL.md#moving-from-a-format-that-is-no-longer-published) or sign in again.

The Arch package adds a menu entry for you. For the AppImage, see below.

## On a Samsung or LG TV (beta)

Samsung TVs from 2020, LG TVs on webOS 5 or newer. Nothing to install: TMPlayer opens in the TV's browser.

1. ### Open the TV's browser

   It is in the TV's list of apps: Internet on a Samsung TV, Web Browser on an LG TV.

2. ### Go to web.tmplayer.org

   Type web.tmplayer.org with the remote. The page sees a Samsung or LG TV and opens TMPlayer's TV version, moved with the remote's arrows. Bookmark it to come back.

3. ### Sign in

   Scan the QR code on the TV with Telegram on your phone: *Settings*, *Devices*, *Link Desktop Device*.

It is a beta: not yet tried on every model, and it plays what the TV's browser can decode. [The Samsung and LG guide](https://tmplayer.org/guides/telegram-on-samsung-or-lg-tv/#tmplayer-on-the-tv) has the other ways, and the packages for developers.

## On the desktop, in the menu, on the taskbar

How to keep it one click away.

### Windows

It is already in Start and on the desktop. To pin it, right click it in Start and choose *Pin to taskbar*.

### Linux: the Arch package

It is in the app menu as soon as it installs, under Multimedia or Sound and Video.

**GNOME:** right click it in Activities, *Pin to Dash*. **KDE Plasma:** right click it in the launcher, *Pin to Task Manager*.

### Linux: AppImage, in the app menu

A single file has no menu entry, so make one. These commands move the AppImage into place, fetch the icon and write a launcher:

#### Make the launcher by hand

```
mkdir -p ~/Applications ~/.local/share/icons ~/.local/share/applications
mv ~/Downloads/TMPlayer-<version>-x86_64.AppImage ~/Applications/TMPlayer.AppImage
chmod +x ~/Applications/TMPlayer.AppImage
curl -Lo ~/.local/share/icons/tmplayer.png https://tmplayer.org/icon-512.png

cat > ~/.local/share/applications/tmplayer.desktop <<EOF
[Desktop Entry]
Type=Application
Name=TMPlayer
Comment=Telegram media player
Exec=$HOME/Applications/TMPlayer.AppImage
Icon=$HOME/.local/share/icons/tmplayer.png
Categories=AudioVideo;Video;Player;
Terminal=false
StartupWMClass=com-tmplayer-desktop-MainKt
EOF

chmod +x ~/.local/share/applications/tmplayer.desktop
update-desktop-database ~/.local/share/applications
```

Then pin it as above.

Prefer clicking? [Gear Lever](https://flathub.org/apps/it.mijorus.gearlever) and [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) do all this for you.

### Linux: an icon on the desktop

Copy the launcher made above to the desktop and mark it trusted:

```
cp ~/.local/share/applications/tmplayer.desktop ~/Desktop/
chmod +x ~/Desktop/tmplayer.desktop
gio set ~/Desktop/tmplayer.desktop metadata::trusted true
```

For the Arch package, copy its launcher instead: `/usr/share/applications/io.github.dracu_lah.TMPlayer.desktop`.

GNOME needs the Desktop Icons NG extension and a one-time *Allow Launching*. KDE Plasma asks once; Xfce and Cinnamon read the trusted flag.

## If it goes wrong

The fixes for nearly every stuck install.

### The television says the app is blocked or the install button does nothing

Unknown sources is set per app. Turn it on for Downloader or Send files to TV, not TMPlayer, then open the file again.

### adb connect refuses the connection

Turn on network debugging, use the same network on both, and accept the trust prompt on the TV screen.

### The QR code will not scan from across the room

Stand closer and hold the phone square to the screen. Scan from Telegram's Settings, Devices, Link Desktop Device, not the camera app.

### Windows shows no Run anyway button

Click *More info* first. A work computer may block unsigned apps by policy.

### The AppImage does nothing when opened

Usually FUSE is missing. Install `libfuse2t64` (Ubuntu 24.04 and newer) or `libfuse2` (22.04), or skip FUSE with `./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run`.

### The window is blank or grey on a tiling window manager

On sway, i3, Hyprland and similar, start it with `_JAVA_AWT_WM_NONREPARENTING=1` set.

Still stuck? [Open an issue](https://github.com/dracu-lah/TMPlayer/issues) with your device, its version and what the screen said.

## 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.

[Buy me a coffee](https://buymeacoffee.com/nevil.dev) [Pay by UPI (India)](upi://pay?pa=nevilnicks4321@okaxis&pn=TMPlayer&cu=INR&tn=TMPlayer%20support)
