ヘルプ

形式は三つあり、いずれも自己完結しています —— Python、Qt、libmpv、ffmpeg はダウンロードの中に入っているので、横に何かを入れる必要はありません。

AppImage —— 迷ったらこれです。どのディストリビューションでも動きます:

chmod +x dopeIPTV-*.AppImage
./dopeIPTV-*.AppImage

Debian や Ubuntu では .deb:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

三つとも arm64 版があり、Raspberry Pi や ARM サーバーで使えます。

.dmg を開き、dopeIPTV をアプリケーションフォルダにドラッグします。macOS 15 以降が必要で、Apple Silicon で動作します —— Intel 版が入っていた最後のリリースは 1.2.10 です。

最初の起動は拒否されます。Apple の公証を受けていないためです。アプリを右クリックして開くを選び、ダイアログでもう一度開くを押してください。それで解決しない場合は下の「macOS がアプリを開けないと言う」を見てください。

インストーラーはありません。dopeIPTV-*-windows-x64.zip を好きな場所に展開し —— ユーザーフォルダで十分で、管理者権限は要りません —— 中の dopeiptv.exe を実行します。

Snapdragon 搭載ノート向けにネイティブの arm64 版があります。x64 版もそこで動きますが、エミュレーション経由なので遅くなります。

スタートメニューやデスクトップにショートカットを作るには: 設定 → インターフェース → メンテナンス → ショートカットを作成。zip 内の README.txt に、跡形なく削除したい場合に消すものが並んでいます。

初回起動時に、Xtream Codes のアカウントから三つの項目を尋ねられます:

• サーバー —— ポート付きのアドレス、たとえば http://example.com:8080。プレイリストの完全な URL ではなく、ホストだけです。
• ユーザー名とパスワード —— プロバイダーから渡されたものです。

これらは保存されます。あとで別のアカウントを足したり、これを編集したりするには 設定 → プレイリスト。アプリを動かしたままプレイリストを切り替えられ、お気に入りと履歴はプレイリストごとに別々に保たれます。

使えます。プレイリストを追加するときに M3U を選び、プロバイダーから渡されたアドレスを貼り付けてください。

ただし Xtream アカウントのほうがアプリの機能を引き出せます —— 見逃し配信、アカウントの有効期限、プロバイダー自身の番組表 —— これらは M3U リストにはない API から来るからです。M3U リストも再生でき、番組表用に独自の XMLTV アドレスを与えられるので、差の大半は埋まります。

試せます。セットアップウィザードがデモチャンネルを用意しています。Mux、Apple、Bitmovin の無料の公開テスト配信がいくつか入っており、何も入力しないうちにアプリの動きを見られます。これらは公式のテスト配信で、誰かのテレビサービスではありません。いつでも本物のプレイリストに移れます。

中央のリストでダブルクリックするか、右のパネルで ▶ 再生 を押します。別のチャンネルを選ぶと、プレイヤーを壊して作り直すのではなくその場でストリームを差し替えます —— チャンネル送りが速いのはそのためです。

プレイヤーバーの前へと次へは、いま開いているリストの中を移動します —— チャンネル、シリーズの各話、録画、履歴。

映画、各話、録画、見逃し配信 —— 長さが分かっているものすべてで:

• ポインタを映像の上に動かすとシークバーがせり上がり、経過時間と全体の時間、−10 秒 / +30 秒のボタンが出ます。
• 映像を一度クリックして矢印キーを使います。一回押すと十秒跳び、押しっぱなしにすると連続して送れます。

生放送のチャンネルはシークできず、シークバーもあえて出しません。生放送の中で移動するにはタイムシフトが必要です —— 下を見てください。

映像をダブルクリックするか F を押します。Esc で抜けられます —— 浮いている操作バーの明示的な全画面を終了ボタンでも同じです。誰も Esc を知らなくて済むように、あえて置いてあります。

操作パネルとマウスポインタは数秒動きがないと隠れ、わずかでも動かすと戻ってきます。

移せます —— プレイヤーを独立したウィンドウに切り離し、好きな場所へドラッグしてください。

既定では枠なしです。映像のどこをつかんでも動かせます。右クリックで常に手前、タイトルバー、終了。Esc でも戻せます。その間もメインウィンドウは動き続けます。

プレイヤーバーの ⚙ ボタン —— 全画面の操作パネルにもあります —— には、いま見ているストリームに関するものがすべて入っています:

• 音声トラックと字幕トラック
• 音声の遅延。音がずれているとき
• アスペクト比（16:9、4:3、引き伸ばしなど）
• ネットワークバッファの大きさ
• Stats for nerds: コーデック、解像度、フレームレート、ハードウェアデコード、A/V 同期、落ちたフレーム、キャッシュとネットワーク速度を映像の上に実時間で

選んだトラックは記憶され、シリーズなら次の話にも引き継がれます。すべてのストリームに効く設定にしたい場合は下の設定を見てください。

• スペース —— 一時停止と再開
• F —— 全画面、抜けるには Esc
• ← / → —— 十秒、押し続けると連続
• M —— 消音

メインウィンドウでも全画面でも切り離したウィンドウでも同じように働きます。

覚えています。映画、シリーズの各話、録画、自分のローカルファイルで有効です。もう一度開くと、その位置から続きを見るか最初からかを尋ねます。

先頭や末尾にごく近い位置はあえて無視します。始めたばかりのものや実際には見終わったものについて、続きを提案しないためです。

プロバイダーからです。リスト上の生放送チャンネルはいま何が放送中かを進捗バー付きで示し、詳細パネルは次に何が来るかを示します。

番組表はプレイリストごとにディスクへ保存されるので、アプリを起動した瞬間から画面に出ています —— 新しいものはバックグラウンドで取得され、置き換わります。その取得が失敗しても、保存済みの番組表が残るので何も見えなくなることはありません。

あります。サイドバーの番組表ボタンで、全チャンネルを覆う検索可能な番組グリッドが開き、時間軸をスクロールできます。検索は番組名で全チャンネルを横断して探します。

見逃し配信のあるチャンネルでは、すでに放送された番組をダブルクリックするとアーカイブから再生されます。

そのプレイリストに、プロバイダーのものではなく独自の番組表を与えてください:

1. 設定 → プレイリスト
2. プレイリストを選んで編集
3. カスタム番組表の欄に XMLTV のアドレスを入れる

プロバイダーが送ってくるものを置き換えます。アプリはまず EPG の id で、次にチャンネル名で番組表と突き合わせるので、別の出所の番組表でもたいていは合います。

実際の放送と合わない時刻を出しているプロバイダーがあります。設定 → 再生に別々の補正が二つあります:

• EPG のずらしは番組表が表示するすべての時刻をずらします。
• 再放送のずらしは、見逃し配信とタイムシフトの再生開始位置をずらします。番組表自体には触れません。

分かれているのは、プロバイダーが一方だけを間違えることがあるからです。

各チャンネルの録画を数日分だけ保持しているプロバイダーがあります。あなたのプロバイダーがそうしている場合、リスト上のチャンネルに ⏪ の印が付き、詳細パネルにアーカイブが何日分さかのぼれるかが出ます。

印がなければ、そのチャンネルにアーカイブは提供されていません。プロバイダー側の設定であり、アプリ側で有効にすることはできません。

プレイヤーの ⏪ ボタンを押すか —— 全画面の操作パネルにもあります —— チャンネルを右クリックしてタイムシフトを選びます。そのあと最初からを選んでください。

流れるのはアーカイブの一部なので、映画と同じようにシークできます。シークバーも矢印キーもその中で働きます。

戻れます。タイムシフトのメニューが過去の番組を日ごとにまとめて並べます —— 見たいものをダブルクリックしてください。決まった幅で戻ることもでき、その幅はプロバイダーのアーカイブの実際の深さに合わせて三十分から一週間まで変わります。

アーカイブの要求を受け付けておきながら、黙って生放送を返すプロバイダーもあります。アプリはそれを確かめて知らせます。昨日の放送を見ていると思い込ませたりはしません。

入口は二つです:

• プレイヤーの REC ボタン。いま見ているものを録ります。
• 任意のチャンネルを右クリック → 録画。見ていないチャンネルを録ります。

長さを選ばなければ、止めるまで録り続けます。録画中のものも、書き込みながら再生できます。

どちらもできます。REC メニューには 30 分、1、2、4 時間があり、予約録画では開始と終了の時刻を指定します。

予約はアプリの再起動をまたいで残りますが、実行の時刻にアプリが起動している必要があります —— これはプログラムであって常駐サービスではありません。録画 → 実行中と予約で待機中のものを確認できます。

いま見ているチャンネルを録るなら使いません。プレイヤー自身のストリームから分岐するので追加の負担がなく、同時一本しか許さない一般的なアカウントでも動きます。

ただし別のチャンネルの録画や、あとから始まる予約録画は、プロバイダーへの接続を自前で開きます。

プレイヤーからの録画について一点。録画を止めた時点で仕上げられるので、再生を止める、別のチャンネルに移る、ストリームがエラーになる —— いずれも録画を終わらせます。

できます。二段構えです。設定 → 録画にすべての録画へ効く容量上限があります —— 数値に MB、GB、TB を添えます。プレイヤーの REC メニューには、その回だけに効く手早い上限が 250 MB から 10 GB まであります。

設定 → 録画で指定した場所です。サイドバーの録画から辿れ、サブフォルダがそのまま分類になります。フォルダを作る、名前を変える、フォルダ間で移す、複数選んでまとめて削除する、いずれもできます。

生放送のチャンネルを 2、4、6、9 個同時にグリッドで表示する別ウィンドウです。それぞれが独立したストリームで、別々のプレイリスト、さらには別々のアカウントから持ってくることもできます。

サイドバーから開きます。グリッドの大きさは設定 → マルチビューにあります。一つの枠をダブルクリックすると最大化します。

枠をクリックすると、その枠に音が渡ります —— 赤い枠線が、いま聞こえている枠を示します。

どの枠でも右クリックで、消音、音声と字幕のトラック、別の枠との移動や入れ替え、取り外しができます。見逃し配信のあるチャンネルは自分の枠の中に専用のアーカイブ時間軸を持つので、他を生放送のままにして一つだけ巻き戻せます。

実際に使うからです —— 枠ごとに一本。ほとんどの IPTV アカウントは同時に一、二本しか許さないので、九枠のグリッドは大半のプロバイダーにそのまま拒否されます。

アプリは失敗するストリームの壁からそれを知る前に、一度だけそう伝えます。「接続数の上限に達しました」が出るなら、たいていはこれが理由です。

チャンネル、映画、各話を右クリック → Chromecast にキャスト…、そして機器を選びます。生放送のチャンネルは HLS で送られます。Cast の受信側が期待している形式です。

キャストを始めると手元の再生は止まります —— 両方同時ならプロバイダーへの二本目の接続になってしまうからです。プレイヤーの上の帯に機器名と再生中のものが出て、停止ボタンが付きます。アプリ側で何かを再生してもキャストは終わり、再生が手元に戻ります。

ふつうの H.264 映像に Dolby Digital Plus の音声が付いたチャンネルがあります。Ultra でも Google TV でもない Chromecast にはそのデコーダーがなく、理由も告げずにストリームを拒みます。

アプリはそうした場合だけこのパソコン上で変換し、結果をあなたのネットワーク内で配ります。映像はそのままコピーして通し —— 再エンコードするのは音声だけで、これは軽い処理です —— しかも機器が実際に拒んだあとにしか行いません。機器が再生できるチャンネルには、常にプロバイダーのストリームがそのまま渡ります。

これには ffmpeg が要りますが、パッケージ済みのダウンロードにはすべて入っています。

設定 → Trakt。trakt.tv でアプリケーションを作り、渡される二つのキーを貼り付け、開いたブラウザで認可します。

以降、見たものが記録され、ウォッチリストと履歴をアプリの中で辿れます。自分のローカルファイルも、TMDB がファイルを特定できたものは記録されます。

見られます。サイドバーのローカルファイルが、設定 → ローカルファイルで追加したフォルダを辿ります。

システムがすでにマウントしているネットワーク共有はひとりでに現れます —— Linux の gvfs SMB マウント、macOS の /Volumes 以下の共有、Windows の割り当てドライブ。アプリから見ればどれもただのパスなので、内部に妙な振る舞いをする SMB クライアントは入っていません。

どちらもです。中央の列で切り替えます。

• フォルダはディスク上のままのツリーを見せます。
• ライブラリはファイル名を読み、そこからシーズンと話数を持つシリーズを組み立て、映画は「映画」の下に置きます —— プロバイダー側のセクションと同じ形です。

TMDB からです。名前と年で照合できるものはそこから取ります。照合できないものは映像そのものから切り出した一コマになり、音楽はファイルのタグかフォルダ内のカバー画像からジャケットを取ります。

名前に年もリリースタグもないファイルについては、決して推測しません。これは意図的です。間違ったポスターはサムネイルより悪いからです。照合させたいなら、年を含む名前に変えてください。

します。アルバムはまとめて並び、アーティスト、アルバム、曲名はタグから取ります。再生キューもあり、一曲追加する、フォルダごとキューに入れる、次に再生する、のいずれもできます。一曲終われば自動で次へ進みます。

ビジュアライザーと十バンドのイコライザーもあります。

移動されたか、名前が変わったか、共有がマウントされていないかです。履歴はそのどれかを告げ、黙って失敗するのではなく項目の削除を提案します。

共有なら、マウントしてもう一度試してください —— 項目は以前どおり動きます。

設定 → インターフェース。インターフェースは 27 言語に訳されており、再起動なしで即座に切り替わります。アラビア語、ペルシャ語、ヘブライ語、ウルドゥー語ではレイアウト全体が反転します。

同じタブに五つの配色テーマと七つのアクセント色があり、その場で反映されます。

設定 → 再生で、毎回頼まなくても起きてほしいことを決めます:

• 優先する音声言語
• 字幕の有無と、第一・第二の優先言語
• 既定のアスペクト比とネットワークバッファ
• 「次のエピソード」カードを何分前に出すか —— 出さない、または一分から十分

プレイヤーの ⚙ メニューは、いま見ているストリームについてこれらを上書きできます。

できます。PIN がロックしたカテゴリーとロックしたお気に入りグループを守ります。ロックされたグループは、PIN を入れるまでどのチャンネルが入っているかさえ見せません —— 再生だけでなく中身そのものを隠します。

PIN はソルト付きでハッシュ化して保存され、平文では持ちません。

チャンネル、映画、シリーズを右クリックして名前を変更または非表示にできます。結果は事実上あなた自身が手を入れたプレイリストで、プレイリストごとに保存されます。既定のチャンネルを復元…で、プロバイダーが送ってくるとおりにすべて戻せます。

カテゴリー全体も、カテゴリーの右クリックメニューから非表示、名前変更、ロックができます。非表示のカテゴリーのチャンネルは「すべて」からも外れます。

設定 → プレイリストでいくつでも追加でき、アプリを動かしたまま切り替えられます。それぞれがお気に入り、履歴、非表示チャンネル、名前の変更を別々に持ちます。

それぞれに独自の XMLTV アドレスと更新間隔も設定できます —— しない、起動時、2、6、12 時間ごと、毎日、毎週。

ログは「動かない」を直せるものに変えてくれます。資格情報は自動で伏せられるので、issue にそのまま添付して構いません。

ターミナルから DOPEIPTV_LOG_FILE を設定して起動すると、画面に出すだけでなくそこにも書き出します。

Linux — AppImage

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log ./dopeIPTV-*.AppImage

Linux — .deb または pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log \
  /Applications/dopeIPTV.app/Contents/MacOS/dopeiptv

Windows — PowerShell、展開したフォルダの中で

$env:DOPEIPTV_LOG_FILE="$env:TEMP\dopeiptv.log"
.\dopeiptv.exe

問題を再現し、アプリを閉じて、そのファイルを添えてください。さらに詳しくしたければ、同じコマンドの前に DOPEIPTV_LOG=debug を付けます。

ターミナルから起動して —— 上の答えにお使いの環境向けの正確なコマンドがあります —— 何が出力されるか読んでください。たいていはそこに原因が書かれています。

パッケージ版は必要なものをすべて同梱しています。pipx でソースから入れた場合は、ディストリビューションの mpv と ffmpeg も必要です:

sudo apt install mpv ffmpeg     # Debian/Ubuntu
sudo dnf install mpv ffmpeg     # Fedora
sudo pacman -S mpv ffmpeg       # Arch

内蔵プレイヤーが映像の描画面を得られていません。

1. ⚙ → Stats for nerds を開き、そもそもフレームが届いているか見てください —— ストリームの問題か表示の問題かを切り分けられます。
2. Wayland では 設定 → 再生 → X11 バックエンドで実行 を試し、アプリを再起動してください。
3. ターミナルから起動し、GL や mpv に触れている行を探してください。

まだ Apple の公証を受けていないためです。アプリを右クリックして開く、続いてダイアログでも開く —— またはシステム設定 → プライバシーとセキュリティ → このまま開くで許可してください。

macOS が代わりにアプリは「壊れている」と言う場合、それはダウンロード時に付いた検疫フラグです。外してください:

xattr -dr com.apple.quarantine /Applications/dopeIPTV.app

どちらの警告も、アプリに問題があるという意味ではありません。ビルドに署名がないというだけで、署名には有料の Apple 証明書が要ります。

SmartScreen が発行元を認識できないためです。ビルドに署名がなく、署名には有料の証明書が要ります。詳細情報をクリックし、実行を選んでください。

誤検知です。原因のうち二つは 1.2.10 で解消しました。起動プログラムは、ウイルス対策エンジンがシグネチャを持っている既製のものではなくソースからコンパイルするようになり、実行ファイルはきちんとしたバージョン情報を持つようになりました。

それでもエンジンが反応する場合は、ウイルス対策ソフトでそのフォルダを許可し、誤検知を Microsoft に報告してください —— 最終的にそれが、あなただけでなく全員のために解決してくれます。

アプリはプロバイダーに問い合わせ、素っ気ないエラーを出す代わりに理由を平たい言葉で伝えます: アカウントの期限切れ、接続数の上限、ストリームがない、サーバーに届かない、など。

他のチャンネルが再生できるなら、そのチャンネルの問題です。何も再生できないなら 設定 → プレイリストを確認してください —— アカウントのパネルに有効期限と許される接続数が出ています。

アカウントが許す同時ストリーム数がすべて埋まっています。ありそうな順に:

1. マルチビューが開いている —— 枠ごとに一本の接続です。
2. 別のチャンネルの録画が動いている。
3. 別の機器か別の人がアカウントを使っている。
4. 前のセッションがプロバイダー側でまだ切れていない。一分待てば直ることが多いです。

いま見ているチャンネルの録画は二本目の接続には数えられません。

Wayland では GNOME も KDE も、ウィンドウのアイコンを対応するデスクトップエントリから取り、アプリ自身が設定したものは無視します。AppImage には、何かが用意するまでそのエントリがありません。

1. アプリは初回起動時に作成を提案します。承諾し —— そのうえでアプリを再起動してください。開いているウィンドウは起動時のアイコンを保持するからです。
2. 断っていた場合、同じ切り替えが設定 → 再生にあります。
3. それでもアイコンが出ないなら、古いアイコンキャッシュが隠しています。GTK はフォルダではなくそのファイルを読みます:

rm ~/.local/share/icons/hicolor/icon-theme.cache

.deb で入れた場合はエントリが最初からあるので、ここに書いたことは当てはまりません。

この項目はシステム側の独立した mpv か vlc を起動するので、どちらかが入っている必要があります —— 内蔵プレイヤーは追加のものを必要とせず、この件とは無関係です。

sudo apt install mpv vlc        # Debian/Ubuntu
sudo dnf install mpv vlc        # Fedora
sudo pacman -S mpv vlc          # Arch