TMPlayer

InicioCómo instalarlo

Cómo instalarlo, donde sea que mires

En una TV, un teléfono, Windows o Linux. Solo lo haces una vez.

Primero descarga el archivo El INSTALL.md completo

En Android TV o un teléfono: cuatro pasos

Así se instala en un dispositivo Android cualquier app de fuera de la tienda.

  1. Permite apps de fuera de la tienda

    En una TV: Configuración, Preferencias del dispositivo, Información, y luego presiona Compilación siete veces. Activa Fuentes desconocidas para la app que copia el archivo.

    En un teléfono: nada por ahora. Android te pregunta la primera vez que abres el archivo.

  2. Pasa el archivo al dispositivo

    En un teléfono, descarga el APK y ábrelo. En una TV, usa las apps gratuitas Downloader o Send files to TV, o adb en la misma red Wi-Fi:

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

    Antes, activa la depuración por red en las Opciones para desarrolladores.

    En un Fire TV los menús tienen otros nombres: sigue la guía para Fire TV.

  3. Inicio de sesión

    En una TV, escanea el código QR: en Telegram en tu teléfono, abre Ajustes, Dispositivos, Vincular dispositivo de escritorio.

    En un teléfono, ingresa tu número. El código QR igual sirve para una cuenta que está en otro teléfono.

  4. Elige un chat y dale play

    Tus chats se abren como cuadrículas de videos reproducibles. Elige uno y arranca en segundos.

INSTALL.md tiene todos los pasos completos, además de los controles y la solución de problemas.

En Windows

Windows 10 u 11, 64 bits. No necesitas contraseña de administrador.

  1. Descarga el instalador

    Descarga TMPlayer-<version>-windows-x64.msi desde la página de descarga. El zip portable ya no se publica: si lo usabas, borra su carpeta e instala el MSI. Tu sesión y tus ajustes se guardan en tu perfil de usuario, no en esa carpeta, así que se conservan.

  2. Pasa SmartScreen

    La compilación todavía no está firmada, así que Windows dice Windows protegió su PC. Haz clic en Más información y luego en Ejecutar de todas formas.

  3. Instálalo y ábrelo

    Avanza por el instalador. TMPlayer aparece en el menú Inicio y en el escritorio. Un MSI más nuevo lo actualiza ahí mismo.

  4. Inicia sesión con el código QR

    Escanea el código QR con Telegram en tu teléfono: Ajustes, Dispositivos, Vincular dispositivo de escritorio. O elige Iniciar sesión con número de teléfono.

En Linux

x86 de 64 bits, con glibc 2.38 o posterior: Ubuntu 24.04, Debian 13, Fedora 39 y posteriores. Después inicia sesión con el código QR.

AppImage, en cualquier distribución

chmod +x TMPlayer-<version>-x86_64.AppImage
./TMPlayer-<version>-x86_64.AppImage

O marca Permitir ejecutar el archivo como un programa en las propiedades del archivo y haz doble clic en él.

Arch Linux

Compila el paquete desde la receta en desktop/packaging/aur con makepkg -si, o usa el AppImage.

Si vienes del deb, el rpm o el Flatpak

Ya no se publican. Desinstala el anterior (sudo apt remove tmplayer, sudo dnf remove tmplayer o flatpak uninstall io.github.dracu_lah.TMPlayer) y usa el AppImage. Si venías del deb o el rpm, tu sesión y tus ajustes se conservan. El Flatpak los guardaba dentro de su sandbox, así que cópialos antes o vuelve a iniciar sesión.

El paquete de Arch agrega una entrada en el menú por ti. Para el AppImage, mira más abajo.

En el escritorio, en el menú, en la barra de tareas

Cómo tenerlo siempre a un clic.

Windows

Instalación con MSI: ya está en Inicio y en el escritorio. Para anclarlo, haz clic derecho sobre él en Inicio y elige Anclar a la barra de tareas.

Linux: el paquete de Arch

Aparece en el menú de apps apenas se instala, en Multimedia o Sonido y video.

GNOME: haz clic derecho sobre él en Actividades, Anclar al tablero. KDE Plasma: haz clic derecho sobre él en el lanzador, Anclar al gestor de tareas.

Linux: AppImage, en el menú de apps

Un archivo suelto no tiene entrada en el menú, así que hay que crearla. Estos comandos mueven el AppImage a su lugar, descargan el ícono y crean un lanzador:

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

Después ánclalo como se explica arriba.

¿Prefieres hacer clic? Gear Lever y AppImageLauncher hacen todo esto por ti.

Linux: un ícono en el escritorio

Copia al escritorio el lanzador que creaste arriba y márcalo como confiable:

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

Para el paquete de Arch, copia en cambio su lanzador: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME necesita la extensión Desktop Icons NG y elegir Permitir ejecutar una sola vez. KDE Plasma pregunta una vez; Xfce y Cinnamon leen la marca de confiable.

Si algo sale mal

Las soluciones para casi cualquier instalación trabada.

La tele dice que la app está bloqueada o el botón de instalar no hace nada

Los orígenes desconocidos se activan por app. Actívalos para Downloader o Send files to TV, no para TMPlayer, y vuelve a abrir el archivo.

adb connect rechaza la conexión

Activa la depuración por red, usa la misma red en ambos y acepta el aviso de confianza en la pantalla de la tele.

El código QR no se escanea desde el otro lado de la sala

Acércate y sostén el teléfono de frente a la pantalla. Escanea desde Telegram en Ajustes, Dispositivos, Vincular dispositivo de escritorio, no desde la app de cámara.

Windows no muestra el botón Ejecutar de todas formas

Primero haz clic en Más información. Una computadora del trabajo puede bloquear apps sin firmar por política.

El AppImage no hace nada al abrirlo

Casi siempre falta FUSE. Instala libfuse2t64 (Ubuntu 24.04 y posteriores) o libfuse2 (22.04), o evita FUSE con ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run.

La ventana sale en blanco o gris en un gestor de ventanas en mosaico

En sway, i3, Hyprland y similares, ábrelo con _JAVA_AWT_WM_NONREPARENTING=1 definido.

¿Sigues atascado? Abre un issue con tu dispositivo, su versión y lo que decía la pantalla.

Dale una estrella si te sirvió

Si estos pasos llevaron tus videos a la pantalla, una estrella ayuda a que la próxima persona lo encuentre.

Dale una estrella en GitHub Haz un fork del repositorio

GPL-3.0, y gratis para siempre