ホームインストール方法

インストール方法、どこで見る場合でも

テレビ、スマートフォン、Windows、Linuxに対応。必要なのは最初の1回だけです。

Android TVまたはスマートフォンで: 4ステップ

ストア以外のアプリをAndroid端末に入れるときは、どれもこの手順です。

  1. ストア以外からのアプリを許可する

    テレビでは、設定、デバイス設定、概要の順に開き、ビルドを7回押します。ファイルをコピーするアプリで提供元不明のアプリを有効にします。

    スマートフォンでは、今のところ何もする必要はありません。ファイルを初めて開くときにAndroidが確認します。

  2. ファイルを端末に入れる

    スマートフォンでは、APKをダウンロードしてファイルを開きます。テレビでは、無料のDownloaderか Send files to TVのアプリを使うか、同じWi-Fiでadbを使います。

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

    先に、開発者向けオプションでネットワークデバッグを有効にしてください。

    Fire TVでは、メニューの名前が異なります。Fire TVガイドをご覧ください。

  3. サインイン

    テレビでは、QRコードを読み取ります。スマートフォンのTelegramで、設定、デバイス、デスクトップデバイスをリンクの順に開きます。

    スマートフォンでは、代わりに電話番号を入力します。別のスマートフォンのアカウントには、QRコードも使えます。

  4. チャットを選んで再生

    チャットを開くと、再生できる動画がグリッドで並びます。1つ選ぶと数秒で始まります。

INSTALL.md には、すべての手順に加えて、操作方法とトラブルシューティングが載っています。

Windowsの場合

Windows 10または11、64ビット。管理者パスワードは不要です。

  1. インストーラーをダウンロード

    ダウンロードページからTMPlayer-<version>-windows-x64.msiを入手してください。ポータブルzipの配布は終了しました。使っていた場合は、そのフォルダーを削除してMSIをインストールしてください。サインインと設定はそのフォルダーではなくユーザープロファイルに保存されているので、そのまま引き継がれます。

  2. SmartScreenを通過する

    このビルドはまだ署名されていないため、WindowsにWindows によって PC が保護されましたと表示されます。詳細情報をクリックし、実行をクリックしてください。

  3. インストールして開く

    インストーラーの案内に従って進めてください。TMPlayerはスタートメニューとデスクトップに追加されます。新しいMSIを実行すると、その場で更新されます。

  4. 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 true

Arch用パッケージの場合は、代わりにそのランチャーをコピーします: /usr/share/applications/io.github.dracu_lah.TMPlayer.desktop。

GNOMEでは、Desktop Icons NG拡張機能と、1回だけ起動を許可の操作が必要です。KDE Plasmaでは1回だけ確認されます。XfceとCinnamonは、信頼済みフラグを読み取ります。

うまくいかないとき

インストールで止まったときの、ほとんどの対処法です。

テレビに「アプリがブロックされています」と表示される、またはインストールボタンを押しても何も起きない

提供元不明のアプリの許可は、アプリごとの設定です。TMPlayerではなく、DownloaderまたはSend files to TVで有効にしてから、もう一度ファイルを開いてください。

adb connectが接続を拒否する

ネットワークデバッグを有効にし、両方を同じネットワークにつないで、テレビ画面に表示される信頼の確認を承認してください。

離れた場所からだとQRコードを読み取れない

近づいて、スマートフォンを画面に正面から向けてください。カメラアプリではなく、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を作成してください。

役に立ったらスターをお願いします

この手順で動画が再生できたなら、スターが次の人の助けになります。

GPL-3.0で、ずっと無料