AccueilComment l'installer

Comment l'installer, où que vous regardiez

Sur une TV, un téléphone, Windows ou Linux. Vous ne le faites qu'une fois.

Sur Android TV ou un téléphone : quatre étapes

C'est ainsi que n'importe quelle appli hors boutique arrive sur un appareil Android.

  1. Autoriser les applis hors boutique

    Sur une TV : Paramètres, Préférences de l'appareil, À propos, puis appuyez sept fois sur Build. Activez Sources inconnues pour l'appli qui copie le fichier.

    Sur un téléphone : rien pour l'instant. Android demande l'autorisation la première fois que vous ouvrez le fichier.

  2. Mettre le fichier sur l'appareil

    Sur un téléphone, téléchargez l'APK et ouvrez-le. Sur une TV, utilisez les applis gratuites Downloader ou Send files to TV, ou adb sur le même Wi-Fi :

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

    Activez d'abord le débogage réseau dans les Options pour les développeurs.

    Sur une Fire TV, les menus portent d'autres noms : suivez le guide Fire TV.

  3. Connexion

    Sur une TV, scannez le QR code : dans Telegram sur votre téléphone, ouvrez Paramètres, Appareils, Associer un appareil de bureau.

    Sur un téléphone, saisissez plutôt votre numéro. Le QR code fonctionne toujours pour un compte sur un autre téléphone.

  4. Choisissez une discussion et lancez la lecture

    Vos discussions s'ouvrent en grilles de vidéos lisibles. Choisissez-en une : elle démarre en quelques secondes.

INSTALL.md contient toutes les étapes en détail, ainsi que les commandes et le dépannage.

Sur Windows

Windows 10 ou 11, 64 bits. Aucun mot de passe administrateur requis.

  1. Télécharger l'installateur

    Prenez TMPlayer-<version>-windows-x64.msi sur la page de téléchargement. Le zip portable n'est plus publié : si vous l'utilisiez, supprimez son dossier et installez le MSI. Votre connexion et vos paramètres se trouvent dans votre profil utilisateur, pas dans ce dossier, donc ils sont conservés.

  2. Passer SmartScreen

    La version n'est pas encore signée, donc Windows affiche Windows a protégé votre ordinateur. Cliquez sur Informations complémentaires, puis sur Exécuter quand même.

  3. Installez-le et ouvrez-le

    Suivez l'installateur. TMPlayer s'ajoute au menu Démarrer et au bureau. Un MSI plus récent le met à jour sur place.

  4. Connectez-vous avec le QR code

    Scannez le QR code avec Telegram sur votre téléphone : Paramètres, Appareils, Associer un appareil de bureau. Ou choisissez Se connecter par numéro de téléphone.

Sur Linux

x86 64 bits, avec glibc 2.38 ou plus récent : Ubuntu 24.04, Debian 13, Fedora 39 et versions ultérieures. Connectez-vous ensuite avec le QR code.

AppImage, sur toute distribution

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

Ou cochez Autoriser l'exécution du fichier comme un programme dans les propriétés du fichier et double-cliquez dessus.

Arch Linux

Construisez le paquet à partir de la recette dans desktop/packaging/aur avec makepkg -si, ou utilisez l'AppImage.

Si vous passez du deb, du rpm ou du Flatpak

Ils ne sont plus publiés. Supprimez l'ancien (sudo apt remove tmplayer, sudo dnf remove tmplayer ou flatpak uninstall io.github.dracu_lah.TMPlayer) et prenez l'AppImage. Après le deb ou le rpm, votre connexion et vos paramètres sont conservés. Le Flatpak les gardait dans son bac à sable, donc copiez-les d'abord ou reconnectez-vous.

Le paquet Arch ajoute une entrée de menu pour vous. Pour l'AppImage, voir ci-dessous.

Sur le bureau, dans le menu, dans la barre des tâches

Comment l'avoir à portée d'un clic.

Windows

Installation MSI : il est déjà dans Démarrer et sur le bureau. Pour l'épingler, faites un clic droit dessus dans Démarrer et choisissez Épingler à la barre des tâches.

Linux : le paquet Arch

Il est dans le menu des applis dès l'installation, sous Multimédia ou Son et vidéo.

GNOME: faites un clic droit dessus dans Activités, Ajouter aux favoris. KDE Plasma : faites un clic droit dessus dans le lanceur, Épingler au gestionnaire de tâches.

Linux : AppImage, dans le menu des applis

Un fichier seul n'a pas d'entrée de menu, il faut donc en créer une. Ces commandes placent l'AppImage au bon endroit, récupèrent l'icône et écrivent un lanceur :

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

Épinglez-le ensuite comme ci-dessus.

Vous préférez cliquer ? Gear Lever et AppImageLauncher font tout cela pour vous.

Linux : une icône sur le bureau

Copiez sur le bureau le lanceur créé plus haut et marquez-le comme fiable :

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

Pour le paquet Arch, copiez plutôt son lanceur : /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME a besoin de l'extension Desktop Icons NG et d'un Autoriser le lancement ponctuel. KDE Plasma demande une fois ; Xfce et Cinnamon lisent l'indicateur de confiance.

Si ça se passe mal

Les solutions pour presque toutes les installations bloquées.

La télévision indique que l'appli est bloquée, ou le bouton d'installation ne fait rien

Sources inconnues se règle appli par appli. Activez-le pour Downloader ou Send files to TV, pas pour TMPlayer, puis rouvrez le fichier.

adb connect refuse la connexion

Activez le débogage réseau, utilisez le même réseau des deux côtés, et acceptez la demande d'autorisation sur l'écran de la TV.

Le QR code ne se scanne pas depuis l'autre bout de la pièce

Approchez-vous et tenez le téléphone bien face à l'écran. Scannez depuis Paramètres, Appareils, Associer un appareil de bureau dans Telegram, pas depuis l'appli photo.

Windows n'affiche pas de bouton Exécuter quand même

Cliquez d'abord sur Informations complémentaires. Un ordinateur professionnel peut bloquer les applis non signées par une règle.

L'AppImage ne fait rien à l'ouverture

En général, FUSE est absent. Installez libfuse2t64 (Ubuntu 24.04 et versions ultérieures) ou libfuse2 (22.04), ou contournez FUSE avec ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run.

La fenêtre est vide ou grise sur un gestionnaire de fenêtres en mosaïque

Sur sway, i3, Hyprland et les équivalents, lancez-le avec _JAVA_AWT_WM_NONREPARENTING=1 défini.

Toujours bloqué ? Ouvrez un ticket en indiquant votre appareil, sa version et ce que l'écran affichait.

Mettez-lui une étoile si ça vous a aidé

Si ces étapes ont fait apparaître vos vidéos à l'écran, une étoile aide la prochaine personne à le trouver.

GPL-3.0, et gratuit pour de bon