HomeHow to install

How to install it, wherever you watch

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

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.

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.

Other ways

From a phone

Install Send files to TV 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

On an Android phone

Android 6.0 or newer. It takes a minute.

  1. Download the APK

    On the phone, open the download page 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, 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 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 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, 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.

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. 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 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 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 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 and 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 with your device, its version and what the screen said.

Pay by UPI (India)

Any amount counts, and the smallest one is not a small thing. Support it if it is useful to you.

Scan this with GPay, PhonePe, Paytm or any UPI app.

nevilnicks4321@okaxis