TMPlayer

InícioComo instalar

Como instalar, onde quer que você assista

Em uma TV, um celular, no Windows ou no Linux. Você faz isso uma vez só.

Baixe o arquivo primeiro O INSTALL.md completo

No Android TV ou em um celular: quatro passos

É assim que qualquer app de fora da loja chega a um dispositivo Android.

  1. Permitir apps de fora da loja

    Na TV: Configurações, Preferências do dispositivo, Sobre, depois pressione Build sete vezes. Ative Fontes desconhecidas para o app que copia o arquivo.

    No celular: nada por enquanto. O Android pergunta quando você abre o arquivo pela primeira vez.

  2. Leve o arquivo para o dispositivo

    No celular, baixe o APK e abra-o. Na TV, use o Downloader gratuito ou o Send files to TV, apps, ou o adb na mesma rede Wi-Fi:

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

    Ative antes a depuração de rede nas Opções do desenvolvedor.

    No Fire TV os menus têm outros nomes: siga o guia do Fire TV.

  3. Login

    Na TV, escaneie o QR code: no Telegram do celular, abra Configurações, Dispositivos, Conectar dispositivo desktop.

    No celular, digite seu número. O QR code continua funcionando para uma conta em outro celular.

  4. Escolha um chat e toque em reproduzir

    Seus chats se abrem como grades de vídeos reproduzíveis. Escolha um e ele começa em segundos.

INSTALL.md traz todos os passos completos, além de controles e solução de problemas.

No Windows

Windows 10 ou 11, 64 bits. Não precisa de senha de administrador.

  1. Baixe o instalador

    Pegue o TMPlayer-<version>-windows-x64.msi em a página de download. O zip portátil não é mais publicado: se você o usava, apague a pasta dele e instale o MSI. Seu login e suas configurações ficam no seu perfil de usuário, não nessa pasta, então continuam valendo.

  2. Passe pelo SmartScreen

    A compilação ainda não é assinada, então o Windows mostra O Windows protegeu seu PC. Clique em Mais informações e depois em Executar assim mesmo.

  3. Instale e abra

    Avance pelo instalador. O TMPlayer vai para o menu Iniciar e para a área de trabalho. Um MSI mais novo o atualiza no próprio lugar.

  4. Faça login com o QR code

    Escaneie o QR code com o Telegram do celular: Configurações, Dispositivos, Conectar dispositivo desktop. Ou escolha Entrar com número de telefone.

No Linux

x86 de 64 bits, com glibc 2.38 ou mais recente: Ubuntu 24.04, Debian 13, Fedora 39 e posteriores. Depois, faça login com o QR code.

AppImage, em qualquer distribuição

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

Ou marque Permitir execução do arquivo como programa nas propriedades do arquivo e clique duas vezes nele.

Arch Linux

Compile o pacote a partir da receita em desktop/packaging/aur com makepkg -si, ou use o AppImage.

Vindo do deb, rpm ou Flatpak

Esses não são mais publicados. Remova o antigo (sudo apt remove tmplayer, sudo dnf remove tmplayer ou flatpak uninstall io.github.dracu_lah.TMPlayer) e use o AppImage. Depois do deb ou rpm, seu login e suas configurações continuam valendo. O Flatpak os guardava dentro do sandbox, então copie-os para fora antes ou faça login de novo.

O pacote do Arch adiciona uma entrada de menu para você. Para o AppImage, veja abaixo.

Na área de trabalho, no menu, na barra de tarefas

Como deixá-lo a um clique de distância.

Windows

Instalação do MSI: ele já está no menu Iniciar e na área de trabalho. Para fixá-lo, clique com o botão direito nele no Iniciar e escolha Fixar na barra de tarefas.

Linux: o pacote do Arch

Ele aparece no menu de apps assim que é instalado, em Multimídia ou Som e vídeo.

GNOME: clique com o botão direito nele em Atividades, Fixar no Dash. KDE Plasma: clique com o botão direito nele no lançador, Fixar no Gerenciador de tarefas.

Linux: AppImage, no menu de apps

Um arquivo avulso não tem entrada de menu, então crie uma. Estes comandos movem o AppImage para o lugar, baixam o ícone e escrevem um lançador:

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

Depois fixe-o como acima.

Prefere clicar? Gear Lever e AppImageLauncher fazem tudo isso por você.

Linux: um ícone na área de trabalho

Copie o lançador criado acima para a área de trabalho e marque-o como confiável:

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

Para o pacote do Arch, copie o lançador dele: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

O GNOME precisa da extensão Desktop Icons NG e de um Permitir execução único. O KDE Plasma pergunta uma vez; Xfce e Cinnamon leem a marca de confiável.

Se algo der errado

As soluções para quase toda instalação que trava.

A televisão diz que o app está bloqueado ou o botão de instalar não faz nada

Fontes desconhecidas é definido por app. Ative para o Downloader ou o Send files to TV, não para o TMPlayer, e abra o arquivo de novo.

O adb connect recusa a conexão

Ative a depuração de rede, use a mesma rede nos dois e aceite o aviso de confiança na tela da TV.

O QR code não é lido de longe

Chegue mais perto e segure o celular de frente para a tela. Escaneie pelo Telegram, em Configurações, Dispositivos, Conectar dispositivo desktop, não pelo app da câmera.

O Windows não mostra o botão Executar assim mesmo

Clique primeiro em Mais informações. Um computador de trabalho pode bloquear apps não assinados por política.

O AppImage não faz nada quando aberto

Em geral falta o FUSE. Instale libfuse2t64 (Ubuntu 24.04 e mais recentes) ou libfuse2 (22.04), ou dispense o FUSE com ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run.

A janela fica em branco ou cinza em um gerenciador de janelas em mosaico

No sway, i3, Hyprland e similares, inicie-o com _JAVA_AWT_WM_NONREPARENTING=1 definido.

Ainda travado? Abra uma issue com seu dispositivo, a versão dele e o que a tela mostrou.

Dê uma estrela se ajudou

Se esses passos puseram seus vídeos na tela, uma estrela ajuda a próxima pessoa a encontrá-lo.

Dar uma estrela no GitHub Fazer fork do repositório

GPL-3.0, e gratuito para sempre