在 Android TV 或手機上：四個步驟
商店以外的 App 都是這樣裝到 Android 裝置上的。
-
允許安裝商店以外的 App
在電視上：設定、裝置偏好設定、關於，然後連按 版本號碼 七次。為用來傳送檔案的 App 開啟 未知來源。
在手機上：暫時不用做任何設定。第一次開啟檔案時，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 教學。
-
登入
在電視上，掃描 QR 碼：在手機的 Telegram 中，開啟 設定、裝置、連結桌面裝置。
在手機上，則改為輸入你的電話號碼。QR 碼仍可用於另一支手機上的帳號。
-
選一個聊天，按下播放
你的聊天會以格狀顯示可播放的影片。選一部，幾秒內就會開始播放。
INSTALL.md 包含每個步驟的完整說明，以及操作方式與疑難排解。
在 Windows 上
Windows 10 或 11，64 位元。不需要系統管理員密碼。
-
下載安裝程式
從下載頁面取得
TMPlayer-<version>-windows-x64.msi。免安裝的 zip 已不再發布：如果你用過，請刪除它的資料夾並安裝 MSI。你的登入狀態與設定存放在使用者設定檔中，而不是那個資料夾，所以會保留下來。 -
通過 SmartScreen
這個版本尚未簽署，所以 Windows 會顯示 Windows 已保護您的電腦。請按 其他資訊，然後按 仍要執行。
-
安裝並開啟
跟著安裝程式一路按下去。TMPlayer 會出現在開始功能表與桌面上。新版 MSI 會就地升級。
-
用 QR 碼登入
用手機上的 Telegram 掃描 QR 碼：設定、裝置、連結桌面裝置。或選擇 以電話號碼登入。
在 Linux 上
64 位元 x86，glibc 2.38 或更新版本：Ubuntu 24.04、Debian 13、Fedora 39 以後。接著用 QR 碼登入。
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 會讀取信任標記。
如果出了問題
幾乎所有卡關的安裝問題，都有對應的解法。
電視顯示 App 遭到封鎖，或按下安裝按鈕沒有反應
「未知來源」是針對每個 App 設定的。請為 Downloader 或 Send files to TV 開啟，而不是 TMPlayer，然後再次開啟檔案。
adb connect 拒絕連線
開啟網路偵錯，確認兩台裝置在同一個網路，並在電視螢幕上接受信任提示。
隔著房間掃不到 QR 碼
站近一點，並把手機正對螢幕。請從 Telegram 的「設定」、「裝置」、「連結桌面裝置」掃描，而不是用相機 App。
Windows 沒有顯示「仍要執行」按鈕
請先按 其他資訊。公司電腦可能依原則封鎖未簽署的 App。
開啟 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，附上你的裝置、版本，以及畫面上顯示的內容。