TMPlayer

Trang chủCách cài đặt

Cách cài đặt, dù bạn xem ở đâu

Trên TV, điện thoại, Windows hoặc Linux. Bạn chỉ làm một lần.

Tải tệp trước Toàn bộ INSTALL.md

Trên Android TV hoặc điện thoại: bốn bước

Mọi ứng dụng từ ngoài cửa hàng đều được cài lên thiết bị Android theo cách này.

  1. Cho phép cài ứng dụng từ ngoài cửa hàng

    Trên TV: Cài đặt, Tùy chọn thiết bị, Giới thiệu, rồi bấm Bản dựng bảy lần. Bật Nguồn không xác định cho ứng dụng dùng để chép tệp.

    Trên điện thoại: chưa cần làm gì. Android sẽ hỏi khi bạn mở tệp lần đầu.

  2. Đưa tệp vào thiết bị

    Trên điện thoại, tải APK và mở nó. Trên TV, dùng Downloader miễn phí hoặc Send files to TV, hoặc adb cùng mạng Wi-Fi:

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

    Trước tiên hãy bật gỡ lỗi qua mạng trong Tùy chọn nhà phát triển.

    Trên Fire TV, tên các menu khác đi: làm theo hướng dẫn Fire TV.

  3. Đăng nhập

    Trên TV, quét mã QR: trong Telegram trên điện thoại, mở Cài đặt, Thiết bị, Liên kết thiết bị máy tính.

    Trên điện thoại, hãy nhập số điện thoại của bạn. Mã QR vẫn dùng được cho tài khoản trên một điện thoại khác.

  4. Chọn một cuộc trò chuyện và bấm phát

    Các cuộc trò chuyện mở ra thành lưới video có thể phát. Chọn một video và nó bắt đầu sau vài giây.

INSTALL.md có đầy đủ từng bước, cùng phần điều khiển và cách khắc phục sự cố.

Trên Windows

Windows 10 hoặc 11, 64 bit. Không cần mật khẩu quản trị.

  1. Tải trình cài đặt

    Lấy TMPlayer-<version>-windows-x64.msi từ trang tải về. Tệp zip portable không còn được phát hành: nếu bạn từng dùng, hãy xóa thư mục của nó và cài bản MSI. Thông tin đăng nhập và cài đặt của bạn nằm trong hồ sơ người dùng chứ không phải thư mục đó, nên vẫn được giữ lại.

  2. Vượt qua SmartScreen

    Bản dựng chưa được ký, nên Windows báo Windows đã bảo vệ PC của bạn. Bấm Thông tin khác, rồi Vẫn chạy.

  3. Cài đặt và mở

    Bấm tiếp qua trình cài đặt. TMPlayer sẽ có trong menu Start và trên màn hình nền. Bản MSI mới hơn sẽ nâng cấp tại chỗ.

  4. Đăng nhập bằng mã QR

    Quét mã QR bằng Telegram trên điện thoại: Cài đặt, Thiết bị, Liên kết thiết bị máy tính. Hoặc chọn Đăng nhập bằng số điện thoại.

Trên Linux

x86 64 bit, với glibc 2.38 trở lên: Ubuntu 24.04, Debian 13, Fedora 39 trở lên. Sau đó đăng nhập bằng mã QR.

AppImage, trên mọi bản phân phối

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

Hoặc đánh dấu Cho phép thực thi tệp như một chương trình trong thuộc tính của tệp rồi nhấp đúp.

Arch Linux

Dựng gói từ công thức trong desktop/packaging/aur bằng makepkg -si, hoặc dùng AppImage.

Chuyển từ deb, rpm hoặc Flatpak

Các bản này không còn được phát hành. Hãy gỡ bản cũ (sudo apt remove tmplayer, sudo dnf remove tmplayer hoặc flatpak uninstall io.github.dracu_lah.TMPlayer) rồi dùng AppImage. Sau deb hoặc rpm, thông tin đăng nhập và cài đặt của bạn vẫn được giữ lại. Flatpak lưu chúng bên trong hộp cát của nó, nên hãy chép chúng ra trước hoặc đăng nhập lại.

Gói Arch tự thêm một mục vào menu. Với AppImage, xem bên dưới.

Trên màn hình nền, trong menu, trên thanh tác vụ

Cách giữ nó trong tầm một cú bấm.

Windows

Cài bằng MSI: nó đã có trong Start và trên màn hình nền. Để ghim, bấm chuột phải vào nó trong Start và chọn Ghim vào thanh tác vụ.

Linux: gói Arch

Nó có trong menu ứng dụng ngay khi cài xong, dưới mục Đa phương tiện hoặc Âm thanh và Video.

GNOME: bấm chuột phải vào nó trong Activities, Pin to Dash. KDE Plasma: bấm chuột phải vào nó trong trình khởi chạy, Pin to Task Manager.

Linux: AppImage, trong menu ứng dụng

Một tệp đơn lẻ không có mục menu, nên hãy tự tạo. Các lệnh này chuyển AppImage vào đúng chỗ, tải biểu tượng và tạo một trình khởi chạy:

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

Sau đó ghim như ở trên.

Thích bấm chuột hơn? Gear Lever và AppImageLauncher làm tất cả việc này giúp bạn.

Linux: biểu tượng trên màn hình nền

Chép trình khởi chạy vừa tạo ở trên ra màn hình nền và đánh dấu là tin cậy:

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

Với gói Arch, hãy chép trình khởi chạy của nó: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME cần tiện ích Desktop Icons NG và một lần Allow Launching. KDE Plasma chỉ hỏi một lần; Xfce và Cinnamon đọc cờ tin cậy.

Nếu có sự cố

Cách khắc phục cho hầu hết các lần cài đặt bị kẹt.

TV báo ứng dụng bị chặn hoặc nút cài đặt không phản hồi

Nguồn không xác định được đặt riêng cho từng ứng dụng. Hãy bật cho Downloader hoặc Send files to TV, không phải TMPlayer, rồi mở lại tệp.

adb connect từ chối kết nối

Bật gỡ lỗi qua mạng, dùng chung một mạng cho cả hai thiết bị, và chấp nhận lời nhắc tin cậy trên màn hình TV.

Không quét được mã QR từ xa

Đứng gần hơn và giữ điện thoại song song với màn hình. Hãy quét từ Cài đặt, Thiết bị, Liên kết thiết bị máy tính của Telegram, không phải từ ứng dụng camera.

Windows không hiện nút Vẫn chạy

Hãy bấm Thông tin khác trước. Máy tính cơ quan có thể chặn ứng dụng chưa ký theo chính sách.

AppImage không làm gì khi mở

Thường là do thiếu FUSE. Hãy cài libfuse2t64 (Ubuntu 24.04 trở lên) hoặc libfuse2 (22.04), hoặc bỏ qua FUSE bằng ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run.

Cửa sổ trống hoặc xám trên trình quản lý cửa sổ dạng xếp ô

Trên sway, i3, Hyprland và các môi trường tương tự, hãy chạy nó với _JAVA_AWT_WM_NONREPARENTING=1 được đặt.

Vẫn bị kẹt? Mở một issue kèm thiết bị của bạn, phiên bản của nó và nội dung màn hình đã báo.

Hãy gắn sao nếu nó có ích

Nếu các bước này đã đưa video lên màn hình của bạn, một ngôi sao sẽ giúp người sau tìm thấy nó.

Gắn sao trên GitHub Fork kho mã nguồn

GPL-3.0, và miễn phí mãi mãi