TMPlayer

HomeCome installare

Come installarlo, ovunque tu guardi

Su una TV, un telefono, Windows o Linux. Lo fai una volta sola.

Prima scarica il file Il file INSTALL.md completo

Su Android TV o su un telefono: quattro passaggi

Così si installa su un dispositivo Android qualsiasi app esterna allo store.

  1. Consenti le app da fonti esterne allo store

    Su una TV: Impostazioni, Preferenze dispositivo, Informazioni, poi premi Build sette volte. Attiva Origini sconosciute per l'app che copia il file.

    Su un telefono: per ora nulla. Android lo chiede quando apri il file la prima volta.

  2. Porta il file sul dispositivo

    Su un telefono, scarica l'APK e aprilo. Su una TV, usa l'app gratuita Downloader oppure Send files to TV, oppure adb sullo stesso Wi-Fi:

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

    Prima attiva il debug di rete nelle Opzioni sviluppatore.

    Su una Fire TV i menu hanno nomi diversi: segui la guida per Fire TV.

  3. Accesso

    Su una TV, inquadra il codice QR: in Telegram sul telefono, apri Impostazioni, Dispositivi, Collega dispositivo desktop.

    Su un telefono, inserisci invece il tuo numero. Il codice QR funziona comunque per un account su un altro telefono.

  4. Scegli una chat e premi play

    Le tue chat si aprono come griglie di video riproducibili. Scegline uno e parte in pochi secondi.

INSTALL.md contiene ogni passaggio per intero, più comandi e risoluzione dei problemi.

Su Windows

Windows 10 o 11, 64 bit. Non serve la password di amministratore.

  1. Scarica il programma di installazione

    Prendi TMPlayer-<version>-windows-x64.msi da la pagina di download. Lo zip portatile non viene più pubblicato: se lo usavi, elimina la sua cartella e installa l'MSI. L'accesso e le impostazioni sono nel tuo profilo utente, non in quella cartella, quindi restano.

  2. Supera SmartScreen

    La build non è ancora firmata, quindi Windows dice Il PC è stato protetto da Windows. Clicca Ulteriori informazioni, poi Esegui comunque.

  3. Installalo e aprilo

    Procedi nel programma di installazione. TMPlayer finisce nel menu Start e sul desktop. Un MSI più recente lo aggiorna sul posto.

  4. Accedi con il codice QR

    Inquadra il codice QR con Telegram sul telefono: Impostazioni, Dispositivi, Collega dispositivo desktop. Oppure scegli Accedi con il numero di telefono.

Su Linux

x86 a 64 bit, con glibc 2.38 o successiva: Ubuntu 24.04, Debian 13, Fedora 39 e successive. Poi accedi con il codice QR.

AppImage, su qualsiasi distribuzione

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

Oppure seleziona Consenti l'esecuzione del file come programma nelle proprietà del file e fai doppio clic.

Arch Linux

Compila il pacchetto dalla ricetta in desktop/packaging/aur con makepkg -si, oppure usa l'AppImage.

Passare da deb, rpm o Flatpak

Non vengono più pubblicati. Rimuovi quello vecchio (sudo apt remove tmplayer, sudo dnf remove tmplayer o flatpak uninstall io.github.dracu_lah.TMPlayer) e prendi l'AppImage. Dopo deb o rpm, accesso e impostazioni restano. Il Flatpak li teneva dentro il suo sandbox, quindi copiali prima fuori oppure accedi di nuovo.

Il pacchetto per Arch aggiunge da solo una voce nel menu. Per l'AppImage, vedi sotto.

Sul desktop, nel menu, sulla barra delle applicazioni

Come averlo a portata di clic.

Windows

Installazione MSI: è già nel menu Start e sul desktop. Per aggiungerlo alla barra, clic destro nel menu Start e scegli Aggiungi alla barra delle applicazioni.

Linux: il pacchetto per Arch

È nel menu delle app appena installato, sotto Multimedia o Audio e video.

GNOME: clic destro in Attività, Aggiungi ai preferiti. KDE Plasma: clic destro nel launcher, Fissa nel task manager.

Linux: AppImage, nel menu delle app

Un file singolo non ha una voce di menu, quindi creane una. Questi comandi spostano l'AppImage al suo posto, scaricano l'icona e scrivono un launcher:

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

Poi fissalo come sopra.

Preferisci cliccare? Gear Lever e AppImageLauncher fanno tutto questo per te.

Linux: un'icona sul desktop

Copia sul desktop il launcher creato sopra e segnalo come attendibile:

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

Per il pacchetto Arch, copia invece il suo launcher: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME richiede l'estensione Desktop Icons NG e una volta Consenti avvio. KDE Plasma lo chiede una volta; Xfce e Cinnamon leggono il flag di attendibilità.

Se qualcosa va storto

Le soluzioni per quasi ogni installazione bloccata.

La televisione dice che l'app è bloccata o il pulsante di installazione non fa nulla

Origini sconosciute si imposta per ogni app. Attivala per Downloader o Send files to TV, non per TMPlayer, poi apri di nuovo il file.

adb connect rifiuta la connessione

Attiva il debug di rete, usa la stessa rete su entrambi e accetta la richiesta di attendibilità sullo schermo della TV.

Il codice QR non si inquadra da lontano

Avvicinati e tieni il telefono dritto davanti allo schermo. Inquadra da Impostazioni, Dispositivi, Collega dispositivo desktop di Telegram, non dall'app della fotocamera.

Windows non mostra il pulsante Esegui comunque

Clicca prima Ulteriori informazioni. Un computer di lavoro può bloccare le app non firmate per criterio.

L'AppImage non fa nulla quando la apro

Di solito manca FUSE. Installa libfuse2t64 (Ubuntu 24.04 e successive) oppure libfuse2 (22.04), oppure evita FUSE con ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run.

La finestra è vuota o grigia su un window manager a tessere

Su sway, i3, Hyprland e simili, avvialo con _JAVA_AWT_WM_NONREPARENTING=1 impostato.

Sei ancora bloccato? Apri una issue con il tuo dispositivo, la sua versione e cosa diceva lo schermo.

Metti una stella se ti è servito

Se questi passaggi hanno portato i tuoi video sullo schermo, una stella aiuta la prossima persona a trovarlo.

Metti una stella su GitHub Fai il fork del repository

GPL-3.0, e gratuito per sempre