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.
-
Install Downloader
On the TV, open the Play Store, search for Downloader and install the free app by AFTVnews.
-
Type this address into Downloader
Open it and type the address in the box at the top, or just the code:
ortmplayer.org/apk3206503The code works in the Downloader app only. In a browser, use the address.
Press Go. The latest TMPlayer starts downloading straight away.
-
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.
-
Sign in
Open TMPlayer and scan the QR code with Telegram on your phone: Settings, Devices, Link Desktop Device.
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.
stars forks
Star on GitHubOn an Android phone
Android 6.0 or newer. It takes a minute.
-
Download the APK
On the phone, open the download page and tap the download button at the top.
-
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.
-
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.
-
Open PowerShell
Open Start, type PowerShell and press Enter. A normal window is fine; it does not need to run as administrator.
-
Paste this line and press Enter
irm https://tmplayer.org/install.ps1 | iexClick 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.
-
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.
-
Drag it to Applications
Download
TMPlayer-<version>-macos-arm64.dmgfrom the download page, open it, and drag TMPlayer onto Applications. -
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 -
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
-
Download the AppImage
Take
TMPlayer-<version>-x86_64.AppImagefrom the download page. One file, for any distribution. -
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.AppImageOr tick Allow executing file as program in the file's properties and double click it.
-
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.
-
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.
-
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.
-
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.
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.