在 Android TV 或手机上：四个步骤
这是任何商店之外的应用安装到 Android 设备上的方式。
-
允许安装商店之外的应用
在电视上：设置、设备偏好设置、关于，然后连按 版本号 七次。为用来传输文件的应用开启 未知来源。
在手机上：暂时无需操作。首次打开文件时 Android 会询问。
-
把文件传到设备上
在手机上，下载 APK并打开它。在电视上，使用免费的 Downloader 或 Send files to TV 应用，或在同一 Wi-Fi 下使用
adb：adb connect <tv-ip>:5555 adb install TMPlayer-<version>-universal.apk请先在开发者选项中开启网络调试。
Fire TV 上的菜单名称不同：请参阅 Fire TV 指南。
-
登录
在电视上，扫描二维码：在手机上的 Telegram 中，打开 设置、设备、链接桌面设备。
在手机上，改为输入你的手机号。二维码仍可用于另一部手机上的账号。
-
选择聊天，按下播放
你的聊天会显示为可播放视频的网格。选一个，几秒内就会开始播放。
INSTALL.md 包含每一个完整步骤，以及操作方式和故障排除。
在 Windows 上
Windows 10 或 11，64 位。无需管理员密码。
-
下载安装程序
从 下载页面 获取
TMPlayer-<version>-windows-x64.msi。便携版 zip 已不再发布：如果你用过它，请删除其文件夹并安装 MSI。你的登录信息和设置保存在用户配置文件中，而不在该文件夹里，所以会保留。 -
绕过 SmartScreen
该版本尚未签名，所以 Windows 会显示 Windows 已保护你的电脑。点击 更多信息，然后点击 仍要运行。
-
安装并打开
按提示完成安装。TMPlayer 会出现在“开始”菜单和桌面上。更新的 MSI 会原地升级。
-
用二维码登录
用手机上的 Telegram 扫描二维码：设置、设备、链接桌面设备。或选择 使用手机号登录。
在 Linux 上
64 位 x86，glibc 2.38 或更高：Ubuntu 24.04、Debian 13、Fedora 39 及更新版本。然后用二维码登录。
AppImage，适用于任何发行版
chmod +x TMPlayer-<version>-x86_64.AppImage
./TMPlayer-<version>-x86_64.AppImage或者在文件属性中勾选 允许作为程序执行文件，然后双击它。
Arch Linux
用 desktop/packaging/aur 中的构建脚本和 makepkg -si 构建软件包，或直接使用 AppImage。
从 deb、rpm 或 Flatpak 迁移
这些已不再发布。请卸载旧版本（sudo apt remove tmplayer、sudo dnf remove tmplayer 或 flatpak uninstall io.github.dracu_lah.TMPlayer），改用 AppImage。从 deb 或 rpm 迁移后，登录信息和设置会保留。Flatpak 把它们存放在沙盒内，所以请先把它们复制出来，否则需要重新登录。
Arch 软件包会自动添加菜单项。AppImage 请见下文。
在桌面、菜单和任务栏中
如何让它一键可达。
Windows
MSI 安装： 它已经在“开始”菜单和桌面上了。要固定它，请在“开始”中右键点击它，选择 固定到任务栏。
Linux：Arch 软件包
安装后它就会出现在应用菜单的“影音”或“声音和视频”下。
GNOME: 在“活动”中右键点击它，选择 固定到 Dash。KDE Plasma： 在启动器中右键点击它，选择 固定到任务管理器。
Linux：AppImage，添加到应用菜单
单个文件没有菜单项，所以需要自己创建。这些命令会把 AppImage 移到合适位置，获取图标并写入启动器：
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然后按上面的方法固定即可。
喜欢点鼠标？Gear Lever 和 AppImageLauncher 可以替你完成这一切。
Linux：桌面图标
把上面创建的启动器复制到桌面，并标记为受信任：
cp ~/.local/share/applications/tmplayer.desktop ~/Desktop/
chmod +x ~/Desktop/tmplayer.desktop
gio set ~/Desktop/tmplayer.desktop metadata::trusted trueArch 软件包请改为复制它的启动器：/usr/share/applications/io.github.dracu_lah.TMPlayer.desktop。
GNOME 需要 Desktop Icons NG 扩展，并且要执行一次 允许启动。KDE Plasma 只询问一次；Xfce 和 Cinnamon 会读取受信任标记。
出问题了怎么办
几乎所有安装卡住的情况都有解决办法。
电视提示应用被阻止，或安装按钮没反应
“未知来源”是按应用设置的。请为 Downloader 或 Send files to TV 开启，而不是 TMPlayer，然后重新打开文件。
adb connect 拒绝连接
开启网络调试，让两台设备使用同一网络，并在电视屏幕上接受信任提示。
二维码隔着房间扫不上
靠近一些，并让手机正对屏幕。请在 Telegram 的“设置”、“设备”、“链接桌面设备”中扫描，而不是用相机应用。
Windows 没有显示“仍要运行”按钮
请先点击 更多信息。公司电脑可能因策略而阻止未签名的应用。
打开 AppImage 没有任何反应
通常是缺少 FUSE。请安装 libfuse2t64（Ubuntu 24.04 及更新版本）或 libfuse2（22.04），也可以用 ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run 跳过 FUSE。
在平铺式窗口管理器上，窗口是空白或灰色的
在 sway、i3、Hyprland 等环境中，请在设置 _JAVA_AWT_WM_NONREPARENTING=1 的情况下启动它。
还是卡住了？提交 Issue，并附上你的设备、版本以及屏幕上的提示。