StartseiteInstallation

So installierst du es, wo auch immer du schaust

Auf einem TV, Smartphone, unter Windows oder Linux. Du machst es nur einmal.

Auf Android TV oder einem Smartphone: vier Schritte

So kommt jede App von außerhalb des Stores auf ein Android-Gerät.

  1. Apps von außerhalb des Stores erlauben

    Auf einem TV: Einstellungen, Geräteeinstellungen, Info, dann siebenmal auf Build drücken. Aktiviere Unbekannte Quellen für die App, die die Datei überträgt.

    Auf einem Smartphone: noch nichts. Android fragt, wenn du die Datei zum ersten Mal öffnest.

  2. Die Datei aufs Gerät bringen

    Auf einem Smartphone lädst du die APK herunter und öffne sie. Auf einem TV nimmst du die kostenlose App Downloader oder Send files to TV, oder adb im selben WLAN:

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

    Aktiviere vorher in den Entwickleroptionen das Netzwerk-Debugging.

    Auf einem Fire TV heißen die Menüs anders: folge der Fire-TV-Anleitung.

  3. Anmelden

    Scanne auf einem TV den QR-Code: Öffne in Telegram auf deinem Smartphone Einstellungen, Geräte, Desktop-Gerät verknüpfen.

    Auf einem Smartphone gibst du stattdessen deine Nummer ein. Der QR-Code funktioniert weiterhin für ein Konto auf einem anderen Smartphone.

  4. Chat wählen und Play drücken

    Deine Chats öffnen sich als Raster mit abspielbaren Videos. Wähle eins, und es startet in Sekunden.

INSTALL.md enthält jeden Schritt ausführlich, dazu Steuerung und Fehlerbehebung.

Unter Windows

Windows 10 oder 11, 64 Bit. Kein Administratorpasswort nötig.

  1. Installer herunterladen

    Nimm TMPlayer-<version>-windows-x64.msi von der Download-Seite. Das portable Zip wird nicht mehr veröffentlicht: Wenn du es genutzt hast, lösche seinen Ordner und installiere die MSI. Deine Anmeldung und Einstellungen liegen in deinem Benutzerprofil, nicht in diesem Ordner, und bleiben daher erhalten.

  2. SmartScreen umgehen

    Der Build ist noch nicht signiert, deshalb meldet Windows Der Computer wurde durch Windows geschützt. Klicke auf Weitere Informationen, dann auf Trotzdem ausführen.

  3. Installieren und öffnen

    Klicke dich durch den Installer. TMPlayer landet im Startmenü und auf dem Desktop. Eine neuere MSI aktualisiert es direkt.

  4. Mit dem QR-Code anmelden

    Scanne den QR-Code mit Telegram auf deinem Smartphone: Einstellungen, Geräte, Desktop-Gerät verknüpfen. Oder wähle Mit Telefonnummer anmelden.

Unter Linux

64-Bit-x86, mit glibc 2.38 oder neuer: Ubuntu 24.04, Debian 13, Fedora 39 und neuer. Melde dich dann mit dem QR-Code an.

AppImage, auf jeder Distribution

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

Oder setze in den Eigenschaften der Datei den Haken bei Datei als Programm ausführen und klicke doppelt darauf.

Arch Linux

Baue das Paket aus dem Rezept in desktop/packaging/aur mit makepkg -si, oder nimm das AppImage.

Umstieg von deb, rpm oder Flatpak

Diese werden nicht mehr veröffentlicht. Entferne das alte Paket (sudo apt remove tmplayer, sudo dnf remove tmplayer oder flatpak uninstall io.github.dracu_lah.TMPlayer) und nimm das AppImage. Nach deb oder rpm bleiben Anmeldung und Einstellungen erhalten. Das Flatpak hat sie in seiner Sandbox gehalten, also kopiere sie vorher heraus oder melde dich neu an.

Das Arch-Paket legt für dich einen Menüeintrag an. Beim AppImage siehe unten.

Auf dem Desktop, im Menü, in der Taskleiste

So hast du es immer einen Klick entfernt.

Windows

MSI-Installation: Es ist schon im Startmenü und auf dem Desktop. Zum Anheften klickst du im Startmenü mit rechts darauf und wählst An Taskleiste anheften.

Linux: das Arch-Paket

Es steht direkt nach der Installation im App-Menü, unter Multimedia oder Audio und Video.

GNOME: Klicke in Aktivitäten mit rechts darauf, An Dash anheften. KDE Plasma: Klicke im Starter mit rechts darauf, An Aufgabenleiste anheften.

Linux: AppImage, im App-Menü

Eine einzelne Datei hat keinen Menüeintrag, also legst du einen an. Diese Befehle verschieben das AppImage an seinen Platz, holen das Symbol und schreiben einen Starter:

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

Hefte es dann wie oben an.

Lieber klicken? Gear Lever und AppImageLauncher erledigen das alles für dich.

Linux: ein Symbol auf dem Desktop

Kopiere den oben erstellten Starter auf den Desktop und markiere ihn als vertrauenswürdig:

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

Beim Arch-Paket kopierst du stattdessen dessen Starter: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME braucht die Erweiterung Desktop Icons NG und einmalig Starten erlauben. KDE Plasma fragt einmal; Xfce und Cinnamon lesen die Vertrauensmarkierung.

Wenn etwas schiefgeht

Die Lösungen für fast jede hängende Installation.

Der Fernseher meldet, die App sei blockiert, oder die Installieren-Schaltfläche tut nichts

Unbekannte Quellen wird pro App festgelegt. Aktiviere es für Downloader oder Send files to TV, nicht für TMPlayer, und öffne die Datei dann erneut.

adb connect lehnt die Verbindung ab

Aktiviere das Netzwerk-Debugging, nutze auf beiden Geräten dasselbe Netzwerk und bestätige die Vertrauensabfrage auf dem Fernseher.

Der QR-Code lässt sich quer durch den Raum nicht scannen

Geh näher heran und halte das Smartphone parallel zum Bildschirm. Scanne aus den Einstellungen, Geräte, Desktop-Gerät verknüpfen von Telegram, nicht mit der Kamera-App.

Windows zeigt keine Schaltfläche „Trotzdem ausführen“

Klicke zuerst auf Weitere Informationen. Ein Firmencomputer kann unsignierte Apps per Richtlinie blockieren.

Das AppImage tut beim Öffnen nichts

Meist fehlt FUSE. Installiere libfuse2t64 (Ubuntu 24.04 und neuer) oder libfuse2 (22.04), oder umgehe FUSE mit ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run.

Das Fenster ist leer oder grau bei einem Tiling-Fenstermanager

Starte es unter sway, i3, Hyprland und ähnlichen mit gesetztem _JAVA_AWT_WM_NONREPARENTING=1.

Immer noch Probleme? Öffne ein Issue mit deinem Gerät, seiner Version und dem, was der Bildschirm gemeldet hat.

Gib ihm einen Stern, wenn es geholfen hat

Wenn dich diese Schritte zu deinen Videos auf den Bildschirm gebracht haben, hilft ein Stern der nächsten Person, es zu finden.

GPL-3.0 und dauerhaft kostenlos