<img width="350" src="https://user-images.githubusercontent.com/39271166/134050201-8110f076-a939-4b62-8c86-7beaa3d4728c.png" alt="KonomiTV Logo">　<!-- omit in toc -->

<img width="100%" src="https://github.com/user-attachments/assets/6971f354-0418-4305-bf6d-b061142ffec6"> <video controls src="https://github.com/user-attachments/assets/ee0b6df0-3bb0-40da-99f4-798437aa2f9c"></video>

いろいろな場所とデバイスでテレビと録画を快適に見れる、モダンな Web ベースのソフトウェアです。

ユーザーのさまざまな好みがつまった、温かみのある居心地の良い場を作りたいという願いを込めて、KonomiTV と名付けました。
手元の PC・タブレット・スマホをテレビにすることを考えたときに、まったく新しく、使いやすくて快適な視聴体験を創出したい一心で開発を進めています。

計画はかなり壮大ですが、2025年10月時点ではおもに以下の機能のみ実装されています。

• 「テレビをみる」: 高画質/低遅延なリアルタイム視聴に対応し、ニコニコ実況や Twitter のコメントとともに番組を楽しめる、デバイスを選ばない快適な視聴体験
• 「ビデオをみる」: 動画配信サービスのような洗練された UI と、当時の盛り上がりを追体験できるコメント再生機能を備えた、録画番組をゆったりと楽しめる視聴体験
• 「番組表」: 読みやすく色分けされたデザインと軽快な動作で、気になる番組を見つけたら1クリックで録画予約できる [🎉NEW!]
• 「録画予約」: 予約した番組の番組情報や放送時間を一目で把握でき、リアタイ視聴をサポート [🎉NEW!]
• 「マイリスト」: 気になる録画番組をさっと登録して、ゆっくり観たいときに思い出せる、あなたのための視聴リスト
• 「視聴履歴」: 録画番組の視聴状況を自動で追跡し、途中で中断した場合も前回の続きから再開して、あなたの番組鑑賞をサポート
• 「KonomiTV アカウント」: 外出先のスマホでも自宅の PC でも、いつでもどこでも同じマイリスト・視聴履歴・設定を共有できる
• 「クライアント設定」: KonomiTV のクライアントアプリ (PWA) の細かな設定が可能な設定画面
• 「サーバー設定」: KonomiTV サーバーの動作環境や配信設定をカスタマイズできる設定画面

今後もより快適な視聴体験を実現すべく、「番組検索」「キーワード自動予約条件の管理」「録画番組の自動エンコード」「キャプチャ画像の管理」など、さらに便利で使いやすい機能を順次追加していく予定です。

目次 <!-- omit in toc -->

• 設計思想
• 動作環境
  • サーバー
  • クライアント
• 備考・注意事項
• 事前準備
  • チューナーのドライバーを px4_drv に変更する
  • EDCB の事前設定
  • QSVEncC・NVEncC・VCEEncC・rkmppenc に対応した GPU ドライバーのインストール
    • Windows
    • Linux - QSVEncC
    • Linux - NVEncC
    • Linux - VCEEncC
    • Linux - rkmppenc
  • Tailscale の導入
• サーバーのインストール/アップデート
  • 安定版と開発版について
  • Windows
  • Linux
  • KonomiTV にアクセスする
  • デスクトップアプリ・スマホアプリとして使う
  • フィードバックのお願い
• 付録
  • Twitter 実況機能について
    • 1. Chrome 拡張機能「GET cookies.txt LOCALLY」をインストールする
    • 2. シークレットウインドウで Web 版 Twitter にログインする
    • 3. Chrome 拡張機能を起動して Cookie データをエクスポートする
    • 4. KonomiTV の設定画面で Cookie データを入力する
  • https://aa-bb-cc-dd.local.konomi.tv:7000/ の URL について
  • 設定ファイルの編集
    • バックエンドの設定
    • エンコーダーの設定
    • リッスンポートの設定
    • 録画済み番組の保存先フォルダの設定
    • アップロードしたキャプチャ画像の保存先フォルダの設定
  • 局ロゴ
• FAQ
  • Web UI にアクセスすると 502 Bad Gateway エラーが表示される
  • Web UI にアクセスすると「Client sent an HTTP request to an HTTPS server.」と表示される
  • Web UI にアクセスすると「このサイトは安全に接続できません」「～から無効な応答が送信されました。」(ERR_SSL_PROTOCOL_ERROR) と表示される
  • Web UI にアクセスすると、DNS エラーが表示される
  • サーバー再起動のたびに録画ファイルのメタデータ再解析が長時間走る
  • ライブストリーミングの視聴が安定しない・途切れ途切れになる
    • 全般
    • KonomiTV サーバーのある自宅の Wi-Fi につないで視聴しているとき
    • 外出先 (自宅以外) から Tailscale 経由で視聴しているとき
• 開発者向け情報
  • 開発版 KonomiTV のインストール (開発環境の構築)
  • サーバーの起動
  • Windows / PM2 サービスのインストールと起動
    • Windows サービス
    • PM2 サービス
  • クライアントの開発・ビルド
• 寄付・支援について
• Special Thanks
• License

設計思想

<img width="100%" src="https://user-images.githubusercontent.com/39271166/153731898-c9743df8-794b-4498-ac25-017662f38759.png"><br> <img width="100%" src="https://github.com/user-attachments/assets/e2a83d19-5716-4268-840d-cee4b985cb68"><br>

いわゆる TS 抜きでテレビを見ている人の多くが、TVTest でテレビを見て、録画をファイルベースで管理して、録画ファイルをメディアプレイヤーで開いて…といった、ファイルやアーキテクチャベースの視聴の仕方をされているかと思います。
ですが、その中で必ず出てくる BonDriver を選択したり、ファイルをフォルダの中から探しだして選択したり、1話を見終わったから2話を開き直したりといった手間は、本来その番組を視聴し、心いくまで楽しむにあたって、不要な工程ではないかと考えます。雑念、といったほうが分かりやすいでしょうか。

一方世間のトレンドに目を向けてみると、Netflix・Amazon Prime Video・AbemaTV のような配信サイトが幅を利かせています。
これらのサイトが流行っているのは、（良い意味で）何も考えなくても、いつでもどこでも気軽に快適に映像コンテンツを見まくれる、そんなユーザー体験が実現されているからです。
配信サイトとテレビ・録画は「リアルタイムで配信されている」「事前に選んだコンテンツしか視聴できない」など大きな差異もありますが、映像コンテンツを視聴するインターフェイスという点では共通しています。
そこで、テレビと録画の視聴といういまだレガシーな視聴体験が残っている分野に、優れた UX を実現している配信サイトでの概念を取り入れ、まるで自分だけの Netflix のような視聴体験を演出できれば面白いのではないか？と考えました。その仮説と理想を実現すべく、鋭意開発を続けています。

こうした考えから、設計思想として「映像コンテンツを視聴し楽しむ」ために不要な概念や操作を可能なかぎり表層から排除・隠蔽し、ユーザーが本当の目的以外の雑念に気を取られないようなシステムを目指しています。

たとえば TVRemotePlus であった「ストリーム」の概念を KonomiTV では排しています。チャンネルをクリックするだけですぐに視聴できるほか、裏側ではチューナーの共有、同じチャンネルを複数のデバイスで見ているなら自動的に共聴するといった高度な仕組みも備え、ユーザーがストレスなく視聴できるように設計されています。
画質の切り替えの UI も、KonomiTV では多くの動画サイトと同じようにプレイヤー内に統合されています。裏側では毎回エンコーダーを再起動しているのですが、表層からはあたかも事前に複数の画質が用意されているかのように見えるはずです。

一般的な PC で動かす以上使えるリソースには限界がありますし、全てにおいて Netflix のような機能を実装できるわけではありません。それでも使えるリソースの範囲で最大限使いやすいソフトウェアにしていければと、細部に様々な工夫を取り入れています。

当然ながら表に泥臭い処理を見せないようにしている分、裏側の実装がそれなりに大変です。細かいところまで調整しているとかなりの手間と時間がかかります。
それでも私が頑張れば私を含めたユーザーの視聴体験が向上するわけで、必要な犠牲かなと思っています。

<img width="100%" src="https://github.com/user-attachments/assets/933956b2-acd5-45c5-8226-c857d12f2a2a"><br> <img width="100%" src="https://github.com/user-attachments/assets/831cba8a-27e1-4f52-8856-0e0b8fef4ae1"><br>

動作環境

サーバー

• Windows 10/11 PC または Linux (Ubuntu) PC
  • Windows 10 Pro と Ubuntu 20.04 LTS の PC でのみ動作確認を行っています。
    • Windows 11 でも動作するとは思いますが、手元に環境がないため、検証は行っていません（動作報告はいただいています）。
    • 32bit 版の Windows 10 には対応していません。
    • Windows サービスを特殊な方法で強引に動かしている関係で、Active Directory などの企業向けユーザー認証が必要な環境では動作しません。
  • Linux PC は Ubuntu (20.04 LTS 以降) / Debian (11 Bullseye 以降) のみサポートしています。
    • Linux PC では Docker 上にインストールすることもできます（後述）。
      • Ubuntu 24.04 LTS での動作は完全に未検証です。おそらく Docker でインストールした方がトラブルが少ないと思います。
    • Debian での動作確認はしていません。おそらく動くとは思いますが…
    • RedHat 系 OS・Arch Linux でも動作するかもしれませんが、開発/検証リソースが大幅に不足しているため、サポートは行いません。
      • できるだけ Ubuntu の利用を推奨しますが、もし Ubuntu 以外の OS にインストールする際は、Docker でのインストールを推奨します。
      • ビルド済みのサードパーティーライブラリは glibc 2.31 以上に依存しています。Docker を使わずにインストールする場合、glibc 2.30 以下を採用する OS では動作しません。
    • ARM 向けには、Rockchip RK3568 / RK3588 SoC のハードウェアエンコーダーに対応しています。
      • arm64 のみに対応しています。armhf などの 32bit ARM には対応していません。
      • ラズパイ4 / ラズパイ5はハードウェアエンコーダーが非力なのと入手性が微妙なため、サポート予定はありません。
        • ラズパイ5に至ってはハードウェアエンコーダー自体が搭載されていない…
      • ARM 向けのインストーラーも用意していますが、テスト不足のため、動作する保証はありません。
• EDCB または Mirakurun / mirakc
  • KonomiTV のバックエンドには、EDCB または Mirakurun / mirakc のいずれかを選択できます。
  • EDCB は、220122 以降のバージョンの xtne6f 版 EDCB / tkntrec 版 EDCB にのみ対応しています。
    • 220122 以前のバージョンの EDCB では正常に動作しません。<ins>「人柱版10.66」などの古いバージョンをお使いの場合は、EDCB のアップグレードが必要です。</ins>
    • 230922 以降の xtne6f 版 / tkntrec 版 EDCB に更新すると EpgDataCap_Bon の起動が少し高速化され、KonomiTV でより快適にチャンネルを切り替えられるようになります。**
    • 最新の EDCB のビルド済みアーカイブは tsukumijima/DTV-Builds にて配布しています。 こだわりがなければ、DTV-Builds で配布しているアーカイブの利用を強くおすすめします (動作確認も DTV-Builds で配布しているアーカイブで行っています)。
    • KonomiTV と連携するには、さらに EDCB に事前の設定が必要になります（後述）。
    • [サーバー設定] → [常に Mirakurun / mirakc から放送波を受信する] をオンにすると、番組情報取得は EDCB から、放送波の受信は Mirakurun / mirakc から行えます。
      • Linux 環境ではチャンネル選局速度が向上するため、Mirakurun / mirakc サーバーが別途ある場合は強くおすすめします。
    • 240622 以降で実装された Linux 版 EDCB での動作確認は行っていません。私の開発環境では EDCB-Wine で安定稼働しています。
  • Mirakurun は 3.9.0 以降を推奨します。
    • 3.8.0 以下のバージョンでも動作しますが、諸問題で推奨しません。
    • Mirakurun 4.0.0-beta.5 以下のバージョンでは、KonomiTV の起動時のバージョン情報取得によりドロップが発生する問題があります。
      • この問題を回避するには、KonomiTV を 0.13.0 以降に更新するか、Mirakurun を 4.0.0-beta.6 以降に更新する必要があります。
      • 詳細は こちらのツイートスレッド をご確認ください。
  • Mirakurun 互換チューナーサーバーである mirakc も利用できます。
    • 動作確認は最新版のみで行っています。
    • mirakc は局ロゴの収集に対応していないため、局ロゴが同梱されていないチャンネルでは、常にデフォルトの局ロゴが利用されます。
  • リバースプロキシなどで Mirakurun / mirakc に Basic 認証が掛かっていると正常に動作しません。

[!IMPORTANT] KonomiTV サーバー本体は Windows と Linux の両方で動作するように設計されていますが、メディア配信サーバーとして動作するために、多くの外部ソフトウェアを必要とします。
実行環境である CPython や、FFmpeg / QSVEncC などの動画エンコードやストリーミングに必要なツール類は、すべて KonomiTV のサードパーティーライブラリ に同梱されており、OS に依存せず単独で動作するよう細かく調整されています。
そのため、通常は Linux 環境であっても追加のパッケージインストールは必要ありませんが、検証できていない新しい OS ではうまく動作しない可能性もあります。

クライアント

• PC: Google Chrome
  • Windows 版 Microsoft Edge は https://github.com/tsukumijima/KonomiTV/issues/58 の問題 (Edge 側のバグ) があるため非推奨です。
    • 仮にこの問題がなかったとしても、Microsoft Edge では通信節約モード (HEVC) での視聴に有料の HEVC ビデオ拡張機能 プラグインが別途必要になります。Chrome ではこのような制約はないため、Chrome の利用をおすすめします。
  • Firefox でも動作するはずですが、コメント描画が重く、コメント表示をオンにするとライブストリーミングが時折止まることが確認されています。
    • 動作確認も基本行っておらず、積極的なサポートはしていません。Chrome を使うことをおすすめします。
  • Mac Safari はサポートしていません。Mac でも Chrome を使ってください。
• Android: Google Chrome
  • Android の Firefox はサポートしていません。
• iPhone (iOS) / iPad (iPadOS): Safari
  • iOS / iPadOS 17.1 以降のみに対応しています。17.0 以下の iOS / iPadOS バージョンのサポートは廃止されました。
    • iOS 17.1 で ManagedMediaSource API がサポートされたため、KonomiTV 0.9.0 以降では iOS / iPadOS でも PC・Android と同じ再生方式 (mpegts.js) で再生します。
    • メンテナンスコストの観点から、以前の LL-HLS 再生