خانهنحوهٔ نصب

نحوهٔ نصب، هر جا که تماشا می‌کنید

روی تلویزیون، گوشی، Windows یا Linux. فقط یک بار انجامش می‌دهید.

روی Android TV یا گوشی: چهار مرحله

هر برنامه‌ای که از خارج از فروشگاه روی دستگاه Android می‌آید به همین شکل نصب می‌شود.

  1. اجازهٔ نصب برنامه از خارج از فروشگاه

    روی تلویزیون: Settings، Device Preferences، About، سپس هفت بار Build را بزنید. Unknown sources را برای برنامه‌ای که فایل را منتقل می‌کند روشن کنید.

    روی گوشی: فعلاً هیچ. Android بار اول که فایل را باز کنید می‌پرسد.

  2. رساندن فایل به دستگاه

    روی گوشی، APK را دانلود کنید و بازش کنید. روی تلویزیون از Downloader رایگان یا Send files to TV استفاده کنید، یا adb روی همان Wi-Fi:

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

    اول network debugging را در Developer options روشن کنید.

    روی Fire TV نام منوها فرق دارد: راهنمای Fire TV را دنبال کنید.

  3. ورود

    روی تلویزیون، کد QR را اسکن کنید: در Telegram روی گوشی، تنظیمات، دستگاه‌ها، Link Desktop Device را باز کنید.

    روی گوشی به‌جای آن شمارهٔ خود را وارد کنید. کد QR هم برای حسابی که روی گوشی دیگری است کار می‌کند.

  4. یک چت انتخاب کنید و پخش را بزنید

    چت‌های شما به‌صورت شبکه‌ای از ویدیوهای قابل پخش باز می‌شوند. یکی را انتخاب کنید تا در چند ثانیه شروع شود.

INSTALL.md همهٔ مراحل را کامل دارد، به‌علاوهٔ کنترل‌ها و رفع اشکال.

روی Windows

Windows 10 یا 11، 64 بیتی. نیازی به رمز مدیر نیست.

  1. دانلود نصب‌کننده

    TMPlayer-<version>-windows-x64.msi را از صفحهٔ دانلود بگیرید. zip قابل‌حمل دیگر منتشر نمی‌شود: اگر از آن استفاده می‌کردید، پوشه‌اش را پاک کنید و MSI را نصب کنید. ورود و تنظیمات شما در پروفایل کاربری‌تان است، نه در آن پوشه، پس می‌مانند.

  2. گذشتن از SmartScreen

    این نسخه هنوز امضا نشده است، پس Windows می‌گوید Windows protected your PC. روی More info کلیک کنید، سپس Run anyway.

  3. نصب و باز کردن

    مراحل نصب‌کننده را بروید. TMPlayer در منوی Start و روی دسکتاپ قرار می‌گیرد. یک MSI جدیدتر آن را درجا ارتقا می‌دهد.

  4. ورود با کد QR

    کد QR را با Telegram روی گوشی اسکن کنید: تنظیمات، دستگاه‌ها، Link Desktop Device. یا ورود با شمارهٔ تلفن را انتخاب کنید.

روی Linux

x86 64 بیتی، با glibc 2.38 یا جدیدتر: Ubuntu 24.04، Debian 13، Fedora 39 و بعدتر. سپس با کد QR وارد شوید.

AppImage، روی هر توزیعی

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

یا در ویژگی‌های فایل Allow executing file as program را تیک بزنید و دوبار کلیک کنید.

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 آن‌ها را داخل sandbox خودش نگه می‌داشت، پس اول آن‌ها را بیرون کپی کنید یا دوباره وارد شوید.

بستهٔ Arch خودش یک مورد در منو اضافه می‌کند. برای AppImage، پایین را ببینید.

روی دسکتاپ، در منو، در نوار وظیفه

چطور یک کلیک دورتر نگهش دارید.

Windows

نصب با MSI: از قبل در Start و روی دسکتاپ است. برای سنجاق کردن، در Start راست‌کلیک کنید و Pin to taskbar را انتخاب کنید.

Linux: بستهٔ Arch

به محض نصب در منوی برنامه‌ها، زیر Multimedia یا Sound and Video است.

GNOME: در Activities روی آن راست‌کلیک کنید، Pin to Dash. KDE Plasma: در لانچر راست‌کلیک کنید، Pin to Task Manager.

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 true

برای بستهٔ Arch، به‌جای آن لانچرش را کپی کنید: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop.

GNOME افزونهٔ Desktop Icons NG و یک بار Allow Launching لازم دارد. KDE Plasma یک بار می‌پرسد؛ Xfce و Cinnamon پرچم مورد اعتماد را می‌خوانند.

اگر خراب شد

راه‌حل تقریباً هر نصب گیرکرده.

تلویزیون می‌گوید برنامه مسدود است یا دکمهٔ نصب کاری نمی‌کند

Unknown sources برای هر برنامه جداگانه تنظیم می‌شود. آن را برای Downloader یا Send files to TV روشن کنید، نه TMPlayer، سپس فایل را دوباره باز کنید.

adb connect اتصال را رد می‌کند

network debugging را روشن کنید، هر دو را روی یک شبکه بگذارید و درخواست اعتماد را روی صفحهٔ تلویزیون بپذیرید.

کد QR از آن سوی اتاق اسکن نمی‌شود

نزدیک‌تر بایستید و گوشی را مستقیم مقابل صفحه بگیرید. از تنظیمات Telegram، دستگاه‌ها، Link Desktop Device اسکن کنید، نه از برنامهٔ دوربین.

Windows دکمهٔ Run anyway نشان نمی‌دهد

اول روی More info کلیک کنید. رایانهٔ محل کار ممکن است طبق سیاست سازمان برنامه‌های امضانشده را مسدود کند.

AppImage با باز کردن هیچ کاری نمی‌کند

معمولاً FUSE نصب نیست. libfuse2t64 (Ubuntu 24.04 و جدیدتر) یا libfuse2 (22.04) را نصب کنید، یا FUSE را با ./TMPlayer-<version>-x86_64.AppImage --appimage-extract-and-run دور بزنید.

پنجره خالی یا خاکستری است، روی مدیر پنجرهٔ کاشی‌ای

روی sway، i3، Hyprland و مشابه آن‌ها، آن را با _JAVA_AWT_WM_NONREPARENTING=1 تنظیم‌شده اجرا کنید.

هنوز گیر کرده‌اید؟ یک مشکل ثبت کنید با دستگاه، نسخه‌اش و آنچه صفحه گفت.

اگر کمک کرد ستاره بدهید

اگر این مراحل ویدیوهایتان را روی صفحه آورد، یک ستاره به نفر بعدی کمک می‌کند آن را پیدا کند.

GPL-3.0 و برای همیشه رایگان