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

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

計画はかなり壮大ですが、現時点ではテレビをリアルタイムで視聴できる「テレビをみる」と、設定画面のみが実装されています。
将来的には、録画した番組を Netflix をはじめとした配信サイトのような UX で快適に視聴できる「ビデオをみる」など、多くの機能を追加予定です。

目次

• 設計思想
• 動作環境
  • サーバー
  • クライアント
• 備考・注意事項
• 事前準備
  • チューナーのドライバーを px4_drv に変更する
  • EDCB の事前設定
  • QSVEncC・NVEncC・VCEEncC・rkmppenc に対応した GPU ドライバーのインストール
    • Windows
    • Linux
  • Tailscale の導入
• サーバーのインストール/アップデート
  • Windows
  • Linux
  • KonomiTV にアクセスする
  • デスクトップアプリ・スマホアプリとして使う
  • フィードバックのお願い
• 付録
  • https://aa-bb-cc-dd.local.konomi.tv:7000/ の URL について
  • 設定ファイルの編集
    • バックエンドの設定
    • エンコーダーの設定
    • リッスンポートの設定
    • アップロードしたキャプチャ画像の保存先フォルダの設定
  • 局ロゴ
  • KonomiTV (β) 0.5.2 以前からのアップグレード
• 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 経由で視聴しているとき
• 開発者向け情報
  • サーバー
  • クライアント
• 寄付・支援について
• Special Thanks
• License

設計思想

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

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

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

たとえば TVRemotePlus であった「ストリーム」の概念を KonomiTV では排しています。チャンネルをクリックするだけですぐに視聴できるほか、裏側ではチューナーの共有、同じチャンネルを複数のデバイスで見ているなら自動的に共聴するといった高度な仕組みも備え、ユーザーがストレスなく視聴できるように設計されています。
画質の切り替えの UI も、KonomiTV では多くの動画サイトと同じようにプレイヤー内に統合されています。裏側では毎回エンコーダーを再起動しているのですが、表層からはあたかも事前に複数の画質が用意されているかのように見えるはずです。
一般的な PC で動かす以上使えるリソースには限界がありますし、全てにおいて Netflix のような機能を実装できるわけではありません。それでも使えるリソースの範囲で最大限使いやすいソフトウェアにしていければと、細部に様々な工夫を取り入れています。

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

動作環境

サーバー

• Windows 10/11 PC または Linux (Ubuntu) PC
  • Windows 10 Pro と Ubuntu 20.04 LTS の PC でのみ動作確認を行っています。
    • Windows 11 でも動作するとは思いますが、手元に環境がないため、検証はできていません。
    • 32bit 版の Windows 10 には対応していません。
  • Linux PC は Ubuntu (20.04 LTS 以降) / Debian (11 Bullseye 以降) のみサポートしています。
    • Linux PC では、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はハードウェアエンコーダーが非力なのと入手性が微妙なため、当面サポート予定はありません。
      • ARM 向けのインストーラーも用意していますが、テスト不足のため、動作する保証はありません。
• EDCB または Mirakurun
  • KonomiTV のバックエンドには、EDCB または Mirakurun のいずれかを選択できます。
  • EDCB は、220122 以降のバージョンの xtne6f 版 EDCB / tkntrec 版 EDCB にのみ対応しています。
    • 220122 以前のバージョンの EDCB では正常に動作しません。「人柱版10.66」などの古いバージョンをお使いの場合は、EDCB のアップグレードが必要です。
    • 最新の EDCB のビルド済みアーカイブは tsukumijima/DTV-Builds にて配布しています。 こだわりがなければ、DTV-Builds で配布しているアーカイブの利用を強くおすすめします (動作確認も DTV-Builds で配布しているアーカイブで行っています)。
    • KonomiTV と連携するには、さらに EDCB に事前の設定が必要になります（後述）。
  • Mirakurun は 3.9.0 以降を推奨します。
    • 3.8.0 以下のバージョンでも動作しますが、諸問題で推奨しません。
    • リバースプロキシなどで Mirakurun に Basic 認証が掛かっていると正常に動作しません。

クライアント

• PC: Microsoft Edge または Google Chrome
  • Firefox でも動作するはずですが、コメント描画が重く、コメント表示をオンにするとライブストリーミングが時折止まることが確認されています。動作確認もあまりできていないため、Chrome か Edge を使うことをおすすめします。
  • Mac の Safari はサポートしていません。Mac でも Chrome か Edge を使ってください。
• Android: Google Chrome
  • Android の Firefox はサポートしていません。
• iPhone (iOS) / iPad (iPadOS): Safari
  • 技術的な制約により、iOS Safari ではほかのブラウザと異なるストリーミング方式 (LL-HLS) を利用しています。現状の制約は下記の通りです。
    • 放送大学ラジオなどのラジオチャンネルが聴取できません。
    • 低遅延モードのオン/オフは効果がなく、常に低遅延でストリーミングされます。
    • あまりテストされていないため、潜在的なバグがある可能性があります。
  • Safari は全体的にバグが多く開発が大変なため、全体的にあまり動作確認を行っていません。修正できていない不具合があるかもしれません。
  • PWA でも動作しますが、Safari 側のバグで PWA では残念ながら Picture-in-Picture ボタンが動作しません。

備考・注意事項

• 現在 β 版で、まだ実験的なプロダクトです。当初よりかなり安定してきましたが、まだ完璧に保証ができる状態ではありません。
  • 完成予想はおろか、TVRemotePlus で実装していた機能に関してもまだ完全にカバーできていないため、現時点で TVRemotePlus を代替できるレベルには達していません。
• TVRemotePlus の後継という位置づけのソフトですが、それはあくまで精神的なものであり、実際の技術スタックや UI/UX はゼロから設計されています。
  • 確かに TVRemotePlus の開発で得られた知見を数多く活用していますし開発者も同じではありますが、ユーザービリティや操作感は大きく異なるはずです。
  • TVRemotePlus の技術スタックでは解決不可能なボトルネックを根本的に解消した上で、「同じものを作り直す」のではなく、ゼロから新しいテレビ視聴・録画視聴のユーザー体験を作り上げ、追求したいという想いから開発しています。
  • どちらかというと録画視聴機能の方がメインの予定でいますが、前述のとおり、現時点ではテレビのライブ視聴機能のみの実装です。構想は壮大ですが、全て実装し終えるには数年単位で時間がかかるでしょう。
• スマートフォンでは、最低限 iPhone SE2 (4.7インチ) 以上の画面サイズが必要です。
  • 快適に利用するには、画面サイズが 6.1 インチ以上の端末をおすすめします。
  • iPhone 5s (4インチ) サイズには対応しておらず、画面が大幅に崩れます。
• Fire タブレット (Fire HD 10 (2021) / Fire HD 8 (2022)) でも動作します。
  • Fire HD 10 (2021) では Google Play を導入した上で、Google Play 経由で Chrome をインストールしてください。
  • Fire HD 8 (2022) では現状 Google Play が導入できないため、適宜 Chrome の APK を入手してインストールしてください。Chrome は、(Google アカウントとの同期機能以外は) GMS がインストールされていなくても動作します。
• 今後、開発の過程で設定や構成が互換性なく大幅に変更される可能性があります。
• ユーザービリティなどのフィードバック・不具合報告・Pull Requests (PR) などは歓迎します。
  • 技術スタックはサーバー側が Python 3.10 + FastAPI + Tortoise ORM + Uvicorn 、クライアント側が Vue.js 2.x + Vuetify 2.x の SPA です。
    • Vuetify は補助的に利用しているだけで、大部分は独自で書いた SCSS スタイルを適用しています。
  • コメントを多めに書いたりそれなりにきれいにコーディングしているつもりなので、少なくとも TVRemotePlus なんかよりかは読みやすいコードになっている…はず。
  • 他人が見るために書いたものではないのであれですが、一応自分用の 開発資料 と DB設計 的なメモを公開しておきます。もし PR される場合などの参考になれば。

事前準備

チューナーのドライバーを px4_drv に変更する

必須ではありませんが、Windows で PLEX 製チューナーを利用している場合は、事前にドライバーを px4_drv for WinUSB に変更しておくことを強く推奨します。
px4_drv では、公式ドライバーとの比較で、チューナーの起動時間が大幅に短縮されています。
その分 KonomiTV での視聴までにかかる待機時間も速くなるため（5秒以上速くなる）、より快適に使えます。

px4_drv を導入すると、ほかにもドロップが大幅に減って安定するなど、たくさんのメリットがあります！
内蔵カードリーダーが使えないこと、BonDriver の差し替えが必要になることだけ注意してください。

px4_drv for WinUSB のビルド済みアーカイブは tsukumijima/DTV-Builds にて配布しています。

EDCB の事前設定

EDCB バックエンドでは、いくつか EDCB に事前の設定が必要です。
この事前設定を行わないと KonomiTV は正常に動作しません。 必ず下記のとおりに設定してください。

また、必ず 220122 以降のバージョンの xtne6f 版 EDCB / tkntrec 版 EDCB を利用していることを確認してください。
現在利用している EDCB のバージョンは、EpgTimer の設定ウインドウの下に表示されています。KonomiTV でサポートしていない古い EDCB では、このバージョン表示自体がありません。

[動作環境] に記載のとおり、220122 以前や「人柱版10.66」などの古いバージョンをお使いの場合は、EDCB のアップグレードが必要になります。
最新版の EDCB のビルド済みアーカイブは tsukumijima/DTV-Builds にて配布しています。
特にこだわりがなければ、このビルド済みアーカイブで事前に EDCB を最新版にアップグレードしておいてください。

EpgTimer を開き、[設定] → [動作設定] → [全般] から、[EpgTimerSrv の設定画面を開く] をクリックして、EpgTimerSrv の設定画面を開きます。
さらに [その他] タブに切り替え、以下のとおりに設定してください。

• [視聴に使用する BonDriver] に BonDriver を追加する
  • EDCB に登録している BonDriver のうち、ここで設定した BonDriver だけが KonomiTV での視聴に利用されます。
  • [視聴に使用する BonDriver] に追加した BonDriver がすべて録画に使われているときは、KonomiTV からは視聴できません（チューナー不足と表示されます）。
  • また、KonomiTV での視聴中に録画が開始されたとき、その時点でチューナーが足りない場合は録画予約が優先され、KonomiTV 向けのストリーム配信は停止されます。
• [ネットワーク接続を許可する (EpgTimerNW 用)] にチェックを入れる
  • この設定にチェックを入れることで、KonomiTV が TCP API 経由で EDCB と通信できるようになります。
• [ネットワーク接続を許可する (EpgTimerNW 用)] → [アクセス制御] に、+127.0.0.0/8,+10.0.0.0/8,+172.16.0.0/12,+192.168.0.0/16,+169.254.0.0/16,+100.64.0.0/10 と入力する
  • プライベート IP アドレス と Tailscale の 100.x.y.z アドレスからのアクセスを許可する設定です。
  • この数字の羅列の意味を理解している方以外は、そのままコピペして貼り付けることを強くおすすめします。
• [ネットワーク接続を許可する (EpgTimerNW 用)] → [IPv6] のチェックを外す
  • この設定にチェックを入れると、IPv6 アドレスでアクセスできるようになる代わりに、IPv4 アドレスでのアクセスが一切できなくなります (落とし穴…)。
  • IPv4/IPv6 両対応にする設定ではない ため、チェックを外すことを強くおすすめします。
• xtne6f 版 EDCB の場合、[EpgTimerSrv の応答を tkntrec 版互換にする (要再起動)] にチェックを入れる
  • EDCB から局ロゴを取得する際に必要です。変更を適用するには、EpgTimerSrv (EpgTimer Service) を再起動してください。
  • tkntrec 版 EDCB では既定で有効になっています（設定項目自体がありません）。

また、EpgDataCap_Bon にも設定が必要です。
EpgDataCap_Bon を開き、[設定] → [ネットワーク設定] → [TCP送信] から、[SrvPipe] を選択して [追加] ボタンをクリックしてください。 送信先一覧に 0.0.0.1:0-29 (SrvPipe) と表示されていれば OK です。

SrvPipe とは、EpgDataCap_Bon で受信した放送波を EpgTimerSrv (EpgTimer Service) に渡すための、EDCB 固有の特殊な名前付きパイプのことです。
KonomiTV は SrvPipe を経由して EDCB から放送波を受信しているため、この設定を忘れると、テレビのライブストリーミングができません。

必須ではありませんが、この機会に [設定] → [動作設定] → [全サービスを処理対象とする] のチェックを外しておくことを推奨します。

このほか、リモート PC の KonomiTV から EDCB にアクセスする場合は、EpgTimerSrv.exe にファイアウォールが掛かっていると接続に失敗します。
適宜ファイアウォールの設定を変更し、EDCB に接続できるようにしておいてください。

QSVEncC・NVEncC・VCEEncC・rkmppenc に対応した GPU ドライバーのインストール

KonomiTV は、QSVEncC (Intel QSV)・NVEncC (NVIDIA NVENC)・VCEEncC (AMD VCE)・rkmppenc (Rockchip ARM SoC) の4つのハードウェアエンコーダーに標準で対応しています。

FFmpeg (ソフトウェアエンコーダー) は遅い上に CPU 負荷がかなり高くなるため、ハードウェアエンコーダーの利用を強くおすすめします。

Windows

• QSVEncC：Intel Graphics Driver
• NVEncC：NVIDIA Graphics Driver
• VCEEncC：AMD Graphics Driver

それぞれのハードウェアエンコーダーを使用するには、対応した GPU ドライバーのインストールが必要です。
基本的にすでにインストールされていると思います。

古いドライバーを使用している場合は、この機会に最新のドライバーにアップデートしておくことをおすすめします。ドライバーが古すぎると、ハードウェアエンコードに失敗する場合があります。

Linux

QSVEncC では、別途 Intel Media Driver のインストールが必要です。

Linux 版の Intel QSV は、Broadwell (第5世代) 以上の Intel CPU でのみ利用できます。そのため、Haswell (第4世代) 以下の CPU では、Intel Media Driver のインストール有無にかかわらず、QSVEncC を利用できません。
なお、Windows 版の Intel QSV は、Haswell (第4世代) 以下の CPU でも利用できます。

curl -fsSL https://repositories.intel.com/graphics/intel-graphics.key | sudo gpg --dearmor --yes -o /usr/share/keyrings/intel-graphics-keyring.gpg

# Ubuntu 22.04 LTS
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics-keyring.gpg] https://repositories.intel.com/graphics/ubuntu jammy arc' | sudo tee /etc/apt/sources.list.d/intel-graphics.list > /dev/null
# Ubuntu 20.04 LTS
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics-keyring.gpg] https://repositories.intel.com/graphics/ubuntu focal-devel main' | sudo tee /etc/apt/sources.list.d/intel-graphics.list > /dev/null

sudo apt update && sudo apt install -y intel-media-va-driver-non-free intel-opencl-icd libmfxgen1

以上のコマンドを実行して、Intel Media Driver をインストールしてください (Ubuntu 20.04 LTS 以降向け) 。

Docker を使ってインストールする場合は、Intel Media Driver をインストールしなくても動作します（未検証）。
KonomiTV の Docker イメージ には Intel Media Driver が標準でインストールされているほか、Intel Graphics 本体のドライバは Linux カーネルに取り込まれているためです。

以前 Alder Lake (第12世代) 以降の Intel CPU で必要だった libmfx-gen1.2 は、QSVEncC 7.38 以降で libmfxgen1 に置き換えられました。
libmfxgen1 は、Ubuntu 20.04 LTS 以降で利用できます。

Jasper Lake 世代などの一部の CPU や Arc GPU では、別途 HuC ファームウェアのロードを有効にする必要があります。
HuC ファームウェアのロードを有効にするには、/etc/modprobe.d/i915.conf にカーネルパラメーターとして options i915 enable_guc=2 を追記し、システムを再起動してください。
詳細は QSVEncC のドキュメント を確認してください。

NVEncC では、NVIDIA Graphics Driver のインストールが必要です。
基本的にはすでにインストールされていると思います。個人的には ubuntu-drivers コマンドを使って apt でインストールするのがおすすめです。

Docker を使って KonomiTV をインストールする場合は (後述) 、さらに NVIDIA Container Toolkit のインストールが必要です。

# Ubuntu では nvidia-docker2 パッケージをインストールするだけ
sudo apt install -y nvidia-docker2

VCEEncC では、AMDGPU-PRO Driver のインストールが必要です。
古いドライバーがインストールされていると、VCEEncC を利用できないことがあります。最新のドライバーをインストールしてください。

# Ubuntu 20.04 LTS (2022/11時点で最新の amdgpu-install パッケージの URL)
curl -LO https://repo.radeon.com/amdgpu-install/22.20/ubuntu/focal/amdgpu-install_22.20.50200-1_all.deb
# Ubuntu 22.04 LTS (2022/11時点で最新の amdgpu-install パッケージの URL)
curl -LO https://repo.radeon.com/amdgpu-install/22.20/ubuntu/jammy/amdgpu-install_22.20.50200-1_all.deb

# AMDGPU-PRO Driver のインストール
sudo apt install -y ./amdgpu-install_22.20.50200-1_all.deb
sudo apt update && sudo amdgpu-install -y --accept-eula --usecase=graphics,amf,opencl --opencl=rocr,legacy --no-32

# 再起動
sudo reboot

以上のコマンドを実行して、AMDGPU-PRO Driver をインストールしてください (Ubuntu 20.04 LTS 以降向け) 。

rkmppenc のサポートは試験的なものです。また、Rockchip 製 ARM SoC (RK3588/RK3588S など) でのみ利用できます。

# Mali GPU Driver のインストール (RK3588/RK3588S 向け)
## 他の Rockchip SoC の Mali GPU Driver は https://github.com/tsukumijima/libmali-rockchip/releases から入手できる
## RK3588/RK3588S の場合、g610-g6p0 より g610-g13p0 の方が高速に動作する
wget https://github.com/tsukumijima/libmali-rockchip/releases/download/v1.9-1-6f3d407/libmali-valhall-g610-g13p0-wayland-gbm_1.9-1_arm64.deb
sudo apt install -y ./libmali-valhall-g610-g13p0-wayland-gbm_1.9-1_arm64.deb
rm libmali-valhall-g610-g13p0-wayland-gbm_1.9-1_arm64.deb

# rockchip-multimedia-config のインストール
## Rockchip のハードウェアエンコーダーを有効化するための設定パッケージ
wget https://github.com/tsukumijima/rockchip-multimedia-config/releases/download/v1.0.2-1/rockchip-multimedia-config_1.0.2-1_all.deb
sudo apt install -y ./rockchip-multimedia-config_1.0.2-1_all.deb
rm rockchip-multimedia-config_1.0.2-1_all.deb

# 念のため再起動
sudo reboot

以上のコマンドを実行して、Mali GPU Driver と、Rockchip のハードウェアエンコーダーを有効化するための設定パッケージをインストールしてください (Ubuntu 20.04 LTS / Debian 11 Bullseye 以降向け) 。

Tailscale の導入

KonomiTV で外出先からリモート視聴するには、Tailscale というメッシュ VPN ソフトを、サーバー PC とクライアントデバイス双方にインストールしておく必要があります。

KonomiTV を家の中だけで使う分には必須ではありませんが、セットアップがとっても簡単で時間もそこまでかからないので、この機会にインストールしておくことをおすすめします。

厳密にはほかの方法 (OpenVPN・SoftEther・リバースプロキシなど) でもリモート視聴は可能ですが、技術的に難易度がかなり高くネットワークエンジニア以外には難しいこと、Tailscale を使った方法が一番手軽でセキュアなことから、KonomiTV では Tailscale を使ったリモート視聴方法のみ公式にサポートしています。
特にリバースプロキシ経由でのアクセスでは一部機能が正常に動作しなくなるほか、セキュリティ上の問題もあるため、非推奨です。

Tailscale は、デバイスが接続されているネットワークや物理的距離に関係なく、同じアカウントにログインしている Tailscale クライアント (デバイス) 同士で直接通信できる、次世代型のメッシュ VPN です。

VPN サーバーを介さず Tailscale クライアント同士で直接通信するため、通常の VPN よりも高速です。さらに通信は暗号化されるため、セキュアに外出先から自宅のデバイスへアクセスできます。

さらに、デバイスをほかの Tailscale ユーザーとシェアすることもできます。
Google ドライブでファイルへの招待リンクを作って共同編集したい人に送るのと同じ要領で、Tailscale クライアントをインストールしたデバイスをほかのユーザーとシェアできます。
KonomiTV を共有したい家族や親戚に Tailscale アカウントを作成してもらえば、Tailscale ログイン用の Google / Microsoft / GitHub アカウントを家族間で共有することなく、セキュアに KonomiTV をシェアできます。

Tailscale の詳細や導入方法は、以前私が執筆した こちら の記事をご覧ください。
この記事のとおりにセットアップすれば、あとは各デバイスで Tailscale での VPN 接続をオンにしておくだけです。

KonomiTV での利用以外にも、EDCB Material WebUI や EPGStation などの、プライベートネットワーク上の Web サーバーに家の外からアクセスするときにとても便利なサービスです。
20台までは無料ですし (逸般の誤家庭でなければ十分すぎる)、この機会に導入しておくことをおすすめします。

サーバーのインストール/アップデート

KonomiTV には、インストーラー/アップデーター/アンインストーラーの3つのモードを内包した、CLI ベースのインストーラーがあります。
このインストーラーを使えば、とてもかんたんに KonomiTV をインストール/アップデートできます！

インストール時は、KonomiTV のインストーラーを起動したあと、最初の質問で 1 を入力します。
あとは、インストーラーの通りに進めていくだけで、自動的にインストールが開始されます！詳しくは下記のインストール手順をご覧ください。

アップデート/アンインストール時は、KonomiTV のインストーラーを起動したあと、最初の質問でアップデートでは 2 、アンインストールでは 3 を入力します。
その後、KonomiTV がインストールされているフォルダを入力すると、自動的にアップデート/アンインストールが開始されます！

インストール/アップデートにはインターネット接続が必要です。オフラインインストーラーではないため注意してください。

KonomiTV サーバーは特殊な仕組みで動作しているため、通常のアプリと異なり Windows の「設定」や「プログラムと機能」からアンインストールすることはできません。
アンインストールする際は、必ず KonomiTV のインストーラー (アンインストーラーモード) を使ってアンインストールしてください。
インストーラーには後方互換性があるため、インストールされているバージョンより新しいバージョンのインストーラーを使ってアンインストールすることもできます。

以下はインストール時の手順になります。アップデート/アンインストールする際は適宜読み替えてください。

Windows

[動作環境] に記載のとおり、Windows 10 以降の 64bit OS にのみ対応しています。
Windows 8 以前と、32bit OS には対応していません。

Releases ページから、最新の KonomiTV のインストーラーをダウンロードします。
Assets の下にある KonomiTV-Installer.exe をダウンロードしてください。

KonomiTV-Installer.exe がウイルス対策ソフトにウイルスと扱われてしまうことがありますが、誤検知です。一般に Python 製ソフトを exe 化すると問答無用でウイルスだと扱われてしまうことが多く、頭を抱えています…。
適宜お使いのウイルス対策ソフトで、KonomiTV-Installer.exe を許可してください。KonomiTV のインストーラーのソースコードは こちら で公開しています。

ダウンロードが終わったら、KonomiTV-Installer.exe をダブルクリックで実行します。
インストールには管理者権限が必要です。

あとは、インストーラーの通りに必要事項を入力していけば、インストールがはじまります！
スペックにもよりますが、インストールには少し時間がかかります。気長に待ちましょう。

インストール処理の終盤で、KonomiTV の実行ユーザー名と、パスワードの入力を求められます。

これは KonomiTV の Windows サービスを一般ユーザーの権限で起動するために利用するものです。入力されたユーザー名やパスワードがそれ以外の用途に利用されることはありません。 実行ユーザー名を入力せずに Enter キーを押すと、デフォルトで現在ログオン中のユーザーが利用されます。
なお、PIN などのほかの認証方法には対応していません。必ず通常のパスワードを入力してください。

KonomiTV の Windows サービスを一般ユーザーの権限で起動することで、KonomiTV からユーザーのネットワークドライブにアクセスできるようになります。

KonomiTV の Windows サービスは、PC の起動後数分遅れてから起動します。 PC の起動直後は EDCB や Mirakurun の Windows サービスがまだ起動していないためです。

指定したユーザーにパスワードを設定していない場合は、簡単なものでいいので何かパスワードを設定してから、その設定したパスワードを入力してください (なお、パスワードの設定後にインストーラーを起動し直す必要はありません) 。

ごく稀に、正しいパスワードを指定したにも関わらず、ログオンできない場合があります。その場合は、一度インストーラーを Ctrl+C で中断してください。
その後、インストーラーの実行ファイル (KonomiTV-Installer.exe) を Shift + 右クリック → [別のユーザーとして実行] をクリックして、ログオン中のユーザー名とパスワードを指定してから、再度インストーラーを実行してみてください。

セキュリティソフトの誤作動により、インストール途中にエラーが発生し、インストールに失敗することがあります。
その場合は一時的にセキュリティソフトのリアルタイムスキャンをオフにしたり、インストール先のフォルダをスキャン対象から除外してから、再度インストーラーを実行してみてください。

Linux

[動作環境] に記載のとおり、Ubuntu 20.04 LTS / Debian 11 Bullseye 以降の OS にのみ対応しています。
それ以外のディストリビューションでも動くかもしれませんが、動作は保証しませんし、今後のサポート予定もありません（Docker ならどの OS でもそれなりに動くような気はします）。

できるだけ Ubuntu の利用を推奨しますが、もし Ubuntu 以外の OS にインストールする際は、Docker でのインストールをおすすめします。

Linux 向けの KonomiTV には、通常のインストール方法と、Docker を使ったインストール方法の 2 通りがあります。

通常のインストール方法では、事前に PM2 と Node.js (PM2 の動作に必要) のインストールが必要です。
Mirakurun や EPGStation を Docker を使わずにインストールしているなら、すでにインストールされているはずです。

Docker を使ったインストール方法では、事前に Docker と Docker Compose のインストールが必要です。
Docker Compose は V1 と V2 の両方に対応していますが、できれば V2 (ハイフンなしの docker compose コマンド) が使えるようにしておくことをおすすめします。

ARM デバイスでは、対応コストの観点から Docker を使ったインストール方法はサポートされていません。

Docker Compose V1 は最終版の 1.29.2 でのみ動作を確認しています。古いバージョンでは正常に動作しない可能性が高いです。
もし Docker Compose V1 が 1.29.2 よりも古い場合は、この機会に V2 への更新をおすすめします。以前よりもグラフィカルに進捗が表示されたりなどのメリットもあります。

[QSVEncC・NVEncC・VCEEncC・rkmppenc に対応した GPU ドライバーのインストール] に記載のとおり、NVIDIA GPU が搭載されている PC に Docker を使ってインストールする場合は、必ず事前に NVIDIA Container Toolkit をインストールしておいてください。
NVIDIA Container Toolkit がインストールされていない場合、KonomiTV のインストールにも失敗する可能性が高いです。

Docker を使ってインストールする場合、動作環境によっては getaddrinfo EAI_AGAIN registry.yarnpkg.com といったエラーで Docker イメージのビルドに失敗することがあります。
Docker の DNS 設定がおかしかったり、Docker が書き換える iptables の定義が壊れてしまっていることが原因のようで、解決方法は千差万別です。
KonomiTV は通常のインストール方法でも極力環境を汚さないように開発されています。Docker を使わずに通常通りインストールしたほうが早いかもしれません。

curl -LO https://github.com/tsukumijima/KonomiTV/releases/download/v0.7.1/KonomiTV-Installer.elf
chmod a+x KonomiTV-Installer.elf
./KonomiTV-Installer.elf

以上のコマンドを実行して KonomiTV-Installer.elf を実行し、インストーラーの通りに進めてください。
インストールには root 権限が必要です。KonomiTV-Installer.elf の実行時に自動的にパスワードを求められます。

ARM デバイスでは、KonomiTV-Installer.elf の代わりに KonomiTV-Installer-ARM.elf をダウンロードしてください。

KonomiTV にアクセスする

「インストールが完了しました！ すぐに使いはじめられます！」と表示されたら、KonomiTV サーバーのインストールは完了です！おつかれさまでした！！🎉🎊
インストーラーに記載されている URL から、KonomiTV の Web UI にアクセスしてみましょう！

通常、(イーサネット) または (Wi-Fi) の URL が家の中からアクセスするときの URL 、(Tailscale) の URL が外出先（家の外）から Tailscale 経由でアクセスするときの URL になります。

https://my.local.konomi.tv:7000/ の URL は、KonomiTV サーバーをインストールした PC 自身を指す URL (ループバックアドレス) です。基本的に使うことはないと思います。

(Tailscale) の URL は、事前に Tailscale を導入していない場合は表示されません（外出先からのアクセス自体は、Tailscale をいつ導入したかに関わらず、Tailscale が起動していれば問題なく行えます）。

KonomiTV サーバーは Windows サービス (Windows) / PM2 サービス (Linux) / Docker サービス (Linux-Docker) としてインストールされているので、サーバー PC を再起動したあとも自動的に起動します。
もし再起動後に KonomiTV にアクセスできない場合は、server/logs/KonomiTV-Server.log に出力されているエラーメッセージを確認してください。

デスクトップアプリ・スマホアプリとして使う

PC 版 Chrome や Edge では、URL バー右のアイコン → [アプリをインストール] から、KonomiTV をブラウザバーのないデスクトップアプリとしてインストールできます！
ブラウザバーが表示されない分、より映像に没頭できますし、画面も広く使えます。私も KonomiTV をデスクトップアプリとして使っています。
タスクバーや Dock に登録しておけば、起動するのも簡単です。ぜひお試しください。

デスクトップアプリとしてインストールしない場合は、[サイトの設定] から自動再生を [許可する] にしておくと、テレビをスムーズに視聴できます。

Android Chrome では下に表示される [ホーム画面に追加] またはメニューの [アプリをインストール] から、iPhone / iPad Safari では共有メニュー → [ホーム画面に追加] から、それぞれ KonomiTV をブラウザバーのないスマホアプリとしてインストールできます！

スマホは画面が小さいので、アプリとしてインストールした方が画面が広くなって使いやすいです。私も KonomiTV をスマホアプリとして使っています。こちらもぜひお試しください。

現状、iPhone / iPad Safari で KonomiTV をスマホアプリとしてインストールすると、Safari のバグの影響で Picture-in-Picture ボタンが利用できなくなります。
とはいえ Picture-in-Picture を使わないのであれば、アプリとしてインストールした方が圧倒的に快適です。

PWA (Progressive Web Apps) という、Web アプリを通常のネイティブアプリのように使えるようにする技術を利用しています。将来的には、PWA だけでなく、より快適に利用できるようにした iOS 向けアプリと Android 向けアプリ (いわゆるガワアプリ) をリリースする予定です。

フィードバックのお願い

KonomiTV はまだまだ開発中のソフトウェアです。

機能が多岐に渡ることと、もとよりテレビのストリーミングという特殊で複雑な技術を扱っていることから、テストが追いつかず慢性的な検証不足に陥っています。
できるだけ手元の環境で検証やテストを行うようにはしていますが、すべての環境や条件を網羅できているわけではありませんし、不具合や問題が残っている可能性は十分にあります。

もし KonomiTV を使っていて、何か不具合や問題が発生した場合は、ぜひ Google フォーム からフィードバックをお願いします…！！
フィードバックしていただけると、KonomiTV の品質改善に大いに役立ちます！

できればマイナーな条件や機能の組み合わせで問題が出ないか、各自でテストしていただけるととても助かります…！
その際、フィードバックフォームには試した環境や条件などを詳細に記載していただけると、問題の再現性が高まります。

KonomiTV ではユーザビリティ (使いやすさ) を第一に考えて UI や細部の機能を緻密に設計しています。
「〇〇の機能/画面が使いづらい」といったフィードバックや、新しい機能のリクエストも大歓迎です。

みなさんからのフィードバックにすべて応えることはできませんが、いただいたフィードバックは KonomiTV の機能向上や改善に役立てさせていただきます！

付録

https://aa-bb-cc-dd.local.konomi.tv:7000/ の URL について

この https://aa-bb-cc-dd.local.konomi.tv:7000/ のフォーマットの URL は、KonomiTV の WebUI に HTTPS でアクセスするための特殊な URL です。

aa-bb-cc-dd の部分には、ローカル IP アドレスのうち、. (ドット) を - (ハイフン) に置き換えた値が入ります。
つまり、サーバー PC のローカル IP アドレスが 192.168.1.11 だったとしたら、https://192-168-1-11.local.konomi.tv:7000/ という URL になります。

ループバックアドレス のみ、https://127-0-0-1.local.konomi.tv:7000/ の代わりに、
・https://my.local.konomi.tv:7000/
・https://local.local.konomi.tv:7000/
・https://localhost.local.konomi.tv:7000/
のシンプルな URL でアクセスできます。

通常、自宅のローカル LAN 上の Web サイトには、http://192.168.1.11:8000/ のような IP アドレス直打ちでの HTTP アクセスがほとんどです。EDCB Material WebUI・TVRemotePlus・Mirakurun・EPGStation などの DTV 関連のソフトでも、同様のアクセス方法が取られてきました。

…ところが、最近のブラウザはインターネット上に公開されている Web サイトのみならず、盗聴のリスクが著しく低いローカル LAN 上の Web サイトにも、HTTPS を要求するようになってきました。
すでに PWA の主要機能である Service Worker などをはじめ、近年追加された多くの Web API の利用に HTTPS が必須になってしまっています。こうした強力な API が HTTP アクセスでは使えないことが、KonomiTV を開発する上で大きな制約になっていました。

そこで KonomiTV では、過去に例のない非常に特殊な仕組みを使い、プライベートネットワーク上の Web サービスにも関わらず 自己署名証明書 のインストールなしで HTTPS でアクセスできるようにしました。
具体的には、Let's Encrypt の DNS 認証 / ワイルドカード証明書・ワイルドカード DNS・Keyless SSL の3つの技術を組み合わせています。tsukumijima/Akebi に技術解説とソースコードを載せていますので、よろしければご覧ください。

この仕組み (Akebi) を使うには、https://192-168-1-11.local.konomi.tv:7000/ のような HTTPS URL でアクセスする必要があります。 当然ですが、プライベート IP アドレス単体では正式な証明書を取得できないためです。

https://(IPアドレス(.を-にしたもの)).local.konomi.tv:7000/ はすべてのプライベート IP アドレスに対応していますが、セキュリティ上の兼ね合いでグローバル IP アドレスには対応していません。
なお、Tailscale の 100.x.y.z アドレス には対応しています。

どうしてもほかの URL でアクセスしたい方向けに、一応サーバー設定 (config.yaml) にカスタム HTTPS 証明書を指定する機能を用意しています。サポートは一切しませんので、すべて理解している方のみ行ってください。

設定ファイルの編集

KonomiTV のサーバー設定は、KonomiTV をインストールしたフォルダにある config.yaml に保存されています。

config.example.yaml は、config.yaml のデフォルトの設定を記載した、config.yaml のひな形となるファイルです。アップデート時に上書きされるため、config.example.yaml は編集しないでください。

設定ファイルは YAML 形式ですが、JSON のようなスタイルで書いています。括弧がないとわかりにくいと思うので… (JSON は YAML のサブセットなので、実は JSON は YAML として解釈可能です)

config.yaml は、インストーラーでインストールした際に自動的に生成されます。
現時点では、サーバー設定の変更には config.yaml 内の記述を直接編集する必要があります。 将来のバージョンでは GUI からサーバー設定を変更できるようにする予定です。

以下は主要な設定項目の説明です。
ほかにも設定項目はありますが、基本的に変更の必要はありません。

バックエンドの設定

KonomiTV のバックエンドには、EDCB または Mirakurun のいずれかを選択できます。
general.backend に EDCB または Mirakurun を指定してください。

EDCB をバックエンドとして利用する場合は、EDCB (EpgTimerNW) の TCP API の URL (general.edcb_url) をお使いの録画環境に合わせて編集してください。

通常、TCP API の URL は tcp://(EDCBのあるPCのIPアドレス):4510/ になります。接続できない際は、ファイアウォールの設定や EpgTimer Service が起動しているかを確認してみてください。
前述のとおり、あらかじめ EDCB の事前設定を済ませておく必要があります。

TCP API の URL として tcp://edcb-namedpipe/ と指定すると、TCP API の代わりに名前付きパイプで通信を行います（KonomiTV と EDCB が同じ PC で起動している場合のみ）。

Mirakurun をバックエンドとして利用する場合は、Mirakurun の HTTP API の URL (general.mirakurun_url) をお使いの録画環境に合わせて編集してください。

通常、HTTP API の URL は http://(MirakurunのあるPCのIPアドレス):40772/ になります。接続できない際は、Mirakurun が起動しているかを確認してみてください。

エンコーダーの設定

エンコーダーには、ソフトウェアエンコーダーの FFmpeg のほか、ハードウェアエンコーダーの QSVEncC・NVEncC・VCEEncC・rkmppenc を選択できます。
general.encoder に FFmpeg / QSVEncC / NVEncC / VCEEncC / rkmppenc のいずれかを指定してください。

ハードウェアエンコーダーを選択すると、エンコードに GPU アクセラレーションを利用するため、CPU 使用率を大幅に下げる事ができます。
エンコード速度も高速になるため、お使いの PC で利用可能であれば、できるだけハードウェアエンコーダーを選択することを推奨します。

お使いの PC で選択したハードウェアエンコーダーが利用できない場合、ライブストリーミング時にその旨を伝えるエラーメッセージが表示されます。まずはお使いの PC でハードウェアエンコーダーが使えるかどうか、一度試してみてください（設定ファイルの変更後はサーバーの再起動が必要です）。

前述のとおり、Linux 環境で QSVEncC・NVEncC・VCEEncC・rkmppenc を利用する場合は、別途 GPU ドライバーのインストールが必要です。

QSVEncC は、Intel 製 CPU の内蔵 GPU に搭載されているハードウェアエンコード機能 (Intel QSV) を利用するエンコーダーです。
ここ数年に発売された Intel Graphics 搭載の Intel 製 CPU であれば基本的に搭載されているため、一般的な PC の大半で利用できます。内蔵 GPU なのにもかかわらず高速で、画質も良好です。

Linux 版の Intel QSV は、Broadwell (第5世代) 以上の Intel CPU でのみ利用できます。そのため、Haswell (第4世代) 以下の CPU では、QSVEncC を利用できません。
なお、Windows 版の Intel QSV は、Haswell (第4世代) 以下の CPU でも利用できます。

NVEncC は、Geforce などの NVIDIA 製 GPU に搭載されているハードウェアエンコード機能 (NVENC) を利用するエンコーダーです。
高速で画質も QSV より若干良いのですが、Geforce シリーズでは同時にエンコードが可能なセッション数が 3 に限定されているため、同時に 3 チャンネル以上視聴することはできません。
同時に 4 チャンネル以上視聴しようとした場合、KonomiTV では「NVENC のエンコードセッションが不足しているため、ライブストリームを開始できません。」というエラーメッセージが表示されます。

VCEEncC は、Radeon などの AMD 製 GPU に搭載されているハードウェアエンコード機能 (AMD VCE) を利用するエンコーダーです。
QSVEncC・NVEncC に比べると安定しない上に、画質や性能もあまり良くありません。もし QSVEncC・NVEncC が使えるならそちらを使うことをおすすめします。

rkmppenc は、RK3588 などの Rockchip 製 ARM SoC に搭載されているハードウェアエンコード機能 (mpp) を利用するエンコーダーです。
画質は VCEEncC と同等くらいですが、ARM デバイスで利用できるハードウェアエンコーダーとしては最高レベルの性能を誇ります。

リッスンポートの設定

server.port に、KonomiTV サーバーのリッスンポートを指定してください。
デフォルトのリッスンポートは 7000 です。

インストーラーでのインストール時にポート 7000 がほかのサーバーソフトと重複している場合は、代わりのポートとして 7100 (7100 も利用できない場合は、さらに +100 される) が自動的にデフォルトのリッスンポートに設定されます。

基本的に変更の必要はありません。変更したい方のみ変更してください。

アップロードしたキャプチャ画像の保存先フォルダの設定

capture.upload_folder に、アップロードしたキャプチャ画像の保存先フォルダを指定してください。

クライアントの [キャプチャの保存先] 設定で [KonomiTV サーバーにアップロード] または [ブラウザでのダウンロードと、KonomiTV サーバーへのアップロードを両方行う] を選択したときに利用されます。

デフォルトの保存先フォルダは、インストーラーで入力したフォルダが自動的に設定されています。
保存先フォルダを変更したくなったときは、この設定を変更してください。

サーバー設定の変更を反映するには、KonomiTV サーバー (KonomiTV Service) の再起動が必要です。

• Windows:「サービス」アプリを開いた後、サービス一覧の中から KonomiTV Service を探して、右クリックメニューから [再起動] をクリックしてください。
  • または、管理者権限のコマンドラインから sc stop "KonomiTV Service"; sc start "KonomiTV Service" を実行してください。
• Linux: sudo pm2 restart KonomiTV を実行してください。
  • sudo をつけないと正しく実行できません (KonomiTV は root ユーザーの PM2 プロファイルに登録されているため) 。
• Linux (Docker): KonomiTV をインストールしたフォルダで docker compose restart を実行してください。

なお、config.yaml が存在しなかったり、設定項目が誤っているとサーバーの起動の時点でエラーが発生します。
その際は server/logs/KonomiTV-Server.log に出力されているエラーメッセージに従い、config.yaml の内容を確認してみてください。

局ロゴ

KonomiTV には、放送波から取得できるものよりも遥かに高画質な局ロゴが同梱されています。
ほとんどの地上波チャンネル・BS/CS の全チャンネル・一部の CATV のコミュニティチャンネルをカバーしており、受信できるチャンネルに対応する局ロゴが同梱されていれば、それが利用されます。

放送波から取得できる局ロゴは最高でも 64x36 で、現代的なデバイスで見るにはあまりにも解像度が低すぎます。とはいえ、局ロゴがなければぱっとチャンネルを判別できなくなり、ユーザー体験が悪化してしまいます。
さらに、局ロゴは何らかの事情で取得できていないことも考えられます。こういった事情もあり、高画質な局ロゴを同梱しています。

チャンネルに対応する局ロゴが同梱されていない場合は、Mirakurun・EDCB のいずれかから局ロゴの取得を試みます。Mirakurun または EDCB から局ロゴを取得できなかった場合は、デフォルトの局ロゴが利用されます。

• Mirakurun:
  • Mirakurun の API から局ロゴの取得を試みます。
  • 基本的には何もしなくても局ロゴが収集されているはずです。
• EDCB:
  • EDCB のロゴデータ保存機能で収集された局ロゴの取得を試みます。
    • ロゴデータ保存機能は 2020年10月に追加された もので、KonomiTV が動作する 220122 以降のバージョンの EDCB なら問題なく利用できます。
  • EpgDataCap_Bon の設定 → [EPG取得設定] → [ロゴデータを保存する] にチェックが入っていて、なおかつ EDCB/Settings/LogoData/ にロゴデータ (PNG) が保存されていることが条件です。

同梱されているロゴは server/static/logos/ に NID(ネットワークID)-SID(サービスID).png (解像度: 256×256) のフォーマットで保存されています。
チャンネルのネットワーク ID とサービス ID がわかっていれば、自分で局ロゴ画像を作ることも可能です。

KonomiTV (β) 0.5.2 以前からのアップグレード

KonomiTV 0.5.2 以前のバージョンをすでにインストールしている場合、直接 0.5.2 から 0.6.0 以降にアップグレードすることはできません。 各種構成に破壊的な変更を多数行ったため、KonomiTV 0.5.2 と 0.6.0 以降には互換性がないためです。

お手数ですが、一度 0.5.2 をインストールしているフォルダを丸ごと削除した上で、新しく 0.6.0 以降をインストールし直してください。

また、KonomiTV 0.6.0-dev 以降のバージョンでは、ポータブル版の Python をサードパーティーライブラリに組み込んでいます。そのため、Python 3.9 / 3.10 を別途インストールする必要はなくなりました。
不要であれば適宜アンインストールしてください（残しておいても動作に支障はありません）。

FAQ

Web UI にアクセスすると 502 Bad Gateway エラーが表示される

KonomiTV サーバーの起動中と考えられます。しばらく待ってから再度アクセスしてみてください。

数分待ってもアクセスできない場合は、KonomiTV サーバーがエラー終了している可能性があります。server/logs/KonomiTV-Server.log に出力されているエラーログを確認してみてください。

Web UI にアクセスすると「Client sent an HTTP request to an HTTPS server.」と表示される

エラーメッセージの通り、http:// でアクセスしてしまっているときに表示されます。
KonomiTV サーバーは HTTPS で起動しているため、Web UI には https:// で始まる URL でアクセスする必要があります。

Web UI にアクセスすると「このサイトは安全に接続できません」「～から無効な応答が送信されました。」(ERR_SSL_PROTOCOL_ERROR) と表示される

https://aa-bb-cc-dd.local.konomi.tv:7000/ の URL について の項目で説明した通り、KonomiTV では過去に例のない非常に特殊な仕組みを使い、自己署名証明書 のインストールなしで HTTPS でアクセスできるようにしています。

Web UI には https://(IPアドレス(.を-にしたもの)).local.konomi.tv:7000/ のフォーマットの HTTPS URL (例: https://192-168-1-11.local.konomi.tv:7000/) でアクセスしてください。
URL が少し長いので、適宜ブックマークやホーム画面に追加しておくと便利です。

上記のフォーマット以外の URL (例: https://localhost:7000/・https://192.168.1.11:7000/) では証明書や HTTPS の通信エラーが発生し、Web UI にアクセスできない仕様になっています。
当然ですが、プライベート IP アドレス単体では正式な証明書を取得できないためです。

Web UI にアクセスすると、DNS エラーが表示される

お使いのルーターで DNS Rebinding Protection が有効になっている可能性があります。

KonomiTV を利用するには、DNS Rebinding Protection を無効にする必要があります。
適宜ルーターの設定を変更するか、お使いのデバイスの DNS を 1.1.1.1 や 8.8.8.8 などの公開 DNS サーバーに変更してください。

OpenWRT では、Rebind Protection のチェックボックスを外すと無効化できるようです。

ライブストリーミングの視聴が安定しない・途切れ途切れになる

原因はいくつか考えられますが、回線速度が遅かったり、不安定な通信環境であることが考えられます。

全般

• KonomiTV サーバーをインストールした PC が有線 LAN に接続されていない可能性があります。
  • KonomiTV サーバーをインストールした PC はできるだけ有線 LAN に接続してください。 Wi-Fi 接続だけでも動作しますが、Wi-Fi 環境次第では通信が不安定になることがあります。
  • LAN 端子がないなどやむを得ず Wi-Fi 接続だけで使う場合は、PC をできるだけ Wi-Fi ルーターに近い場所に配置するなど、安定して通信できることを確認してください。
• デバイスのスペック不足の可能性があります。
  • KonomiTV はブラウザでリッチな視聴体験を実現していますが、その反面どうしてもネイティブアプリに比べると動作が重いです。特に Android のローエンドや数年前の古いスマホでは、スペック不足でストリーミングが安定しないことがあります。
  • 根本的には新しいデバイスに買い替える以外の方法はありませんが、描画処理が重たいニコニコ実況のコメント表示や低遅延ストリーミングをオフにすると、以前より安定して再生できることが多いです。
  • また、画質を 720p 以下に下げて視聴するのも有効です。古いスマホでは液晶の解像度が低めことも多いので、720p 以下に下げても十分視聴に耐えると思います。

KonomiTV サーバーのある自宅の Wi-Fi につないで視聴しているとき

• 遅い Wi-Fi アクセスポイントに接続されている可能性があります。
  • 5GHz 帯の Wi-Fi アクセスポイント (SSID に 5G・A と入っていることが多い) に接続し直してみてください。
  • 5GHz 帯の Wi-Fi アクセスポイントに対応していない古いデバイスをお持ちの方は、この機会に買い替えや 5GHz 対応の USB Wi-Fi ドングルの購入をおすすめします…。
• Wi-Fi ルーターとの距離が離れている可能性があります。Wi-Fi ルーターに近い場所に移動するか、より近い Wi-Fi アクセスポイントに接続し直してください。
  • Wi-Fi ルーターとの距離が離れていると、遮蔽物や減衰の影響で通信が不安定になることがあります。
  • デバイスを Wi-Fi ルーターにできるだけ近づけた状態でストリーミングが安定するなら、Wi-Fi 環境自体に問題がある可能性が高いです（電波干渉が発生している、など）。との距離が離れておらず、通信速度が十分に出ていることを確認してください。
• 低遅延ストリーミングをオフにしてみてください。
  • 低遅延ストリーミングがオンのときは、放送波との遅延を最短 0.9 秒にまで抑えて視聴できます。ただし、回線速度が遅かったり不安定な通信環境だと、ストリーミングが安定しないことがあります。
  • 低遅延ストリーミングをオフにすると、遅延が 5 秒以上になりますが、不安定な通信環境でも安定して視聴できます。
  • 低遅延ストリーミングのオン/オフは [設定] → [全般] から変更できます。
• ストリーミング画質を下げてみてください。
  • デフォルトのストリーミング画質の 1080p では、平均約 10Mbps のデータ量を消費します (通信節約モードがオンなら約 3Mbps に減少する) 。データ量はシーン次第で上下しますが、一般的に動きの激しいシーンや実写ではデータ量が多くなります。
  • 画質を下げることで、回線速度が遅くても安定して視聴できるようになります。
  • スペックの低いデバイスでは、画質を下げるとストリーミングが安定することがあります。
  • デフォルトのストリーミング画質は [設定] → [全般] から変更できます。

外出先 (自宅以外) から Tailscale 経由で視聴しているとき

• 低遅延ストリーミングをオフにしてみてください。
  • 低遅延ストリーミングがオンのときは、放送波との遅延を最短 0.9 秒にまで抑えて視聴できます。ただし、モバイルデータ通信 (4G) やフリー Wi-Fi などのネットワーク遅延の大きい不安定な通信環境では、ストリーミングが安定しないことが多いです。
    • 海外や他の都道府県など地理的に離れた場所から視聴するときは、ネットワーク遅延が特に大きくなります。
  • 低遅延ストリーミングをオフにすると、遅延が 5 秒以上になりますが、不安定な通信環境でも比較的安定して視聴できます。
  • 低遅延ストリーミングのオン/オフは [設定] → [全般] から変更できます。
• ストリーミング画質を下げてみてください。
  • デフォルトのストリーミング画質の 1080p では、平均約 10Mbps のデータ量を消費します (通信節約モードがオンなら約 3Mbps まで減る) 。データ量はシーン次第で上下しますが、一般的に動きの激しいシーンや実写ではデータ量が多くなります。
  • 場所にもよりますが、モバイルデータ通信 (4G) やフリー Wi-Fi では通信速度があまり出ないことが多いです。画質を下げることで、回線速度が遅くても安定して視聴できるようになります。
    • スマホの小さな画面では画質を 720p や 540p まで下げても見た目ほとんど変わらないので、そのあたりまで画質を下げるのがおすすめです。
  • 画質を下げることで、モバイルデータ通信 (4G/5G) で視聴するときのデータ通信量 (いわゆるギガ、パケ代) も抑えられます。 360p や 240p まで下げれば、データ通信量をかなり削減できます。
    • PC サイズの画面で 360p はさすがに厳しいですが、スマホサイズの画面なら 360p でもそれなりに視聴に耐える印象です。
  • スペックの低いデバイスでは、画質を下げるとストリーミングが安定することがあります。
  • デフォルトのストリーミング画質は [設定] → [全般] から変更できます。
• 通信節約モードを有効にしてみてください。
  • 通信節約モードでは、H.265 / HEVC という圧縮率の高いコーデックを使い、画質はほぼそのまま、通信量を通常の 1/2 程度に抑えながら視聴できます。
  • 外出先からモバイルデータ通信 (4G/5G) で視聴するときは常に通信節約モードをオンにしておくことをおすすめします。 画質を保ったまま、データ通信量 (いわゆるギガ、パケ代) をかなり削減できます。
  • ただし、サーバー PC の GPU が H.265 / HEVC でのハードウェアエンコードに対応している必要があります。視聴開始時に「H.265/HEVC でのエンコードに対応していません」というエラーメッセージが表示された場合は、通信節約モードは使えません。
  • 通信節約モードのオン/オフは [設定] → [全般] から変更できます。

開発者向け情報

開発環境は VS Code です。
開発時に推奨する拡張機能は .vscode/extensions.json に記述されています。

サーバー

Uvicorn は ASGI サーバーで、FastAPI で書かれた KonomiTV のアプリケーションサーバーを実行します。
また、KonomiTV の場合は静的ファイルを配信する Web サーバーの役割も兼ねています。

開発時などでサーバーをリロードモード（コードを変更すると自動でサーバーが再起動される）で起動したいときは、pipenv run dev を実行してください。

コードを変更すると強制的にサーバーが再起動されるため、サーバーを終了するタイミングによっては EDCB のチューナーが終了されないままになることがあります。

Python の asyncio の制限により、リロードモードは事実上 Windows 上では利用できません（正確には外部プロセス実行を伴うストリーミング視聴を行わなければ一応機能する）。

API ドキュメント (Swagger) は https://my.local.konomi.tv:7000/api/docs にあります。
API ドキュメントは FastAPI によって自動生成されたものです。
その場で API リクエストを試せたり、グラフィカルに API ドキュメントを参照できたりととても便利です。ぜひご活用ください。

クライアント

クライアント (フロントエンド) は Vue.js 2.x の SPA (Single Page Application) で構築されており、コーディングとビルドには少なくとも Node.js が必要です。
Node.js v18, yarn v1 で開発しています。

クライアントのデバッグは client/ フォルダにて yarn dev または npm run dev を実行し、https://my.local.konomi.tv:7001/ にてリッスンされる開発用サーバーにて行っています。

事前に yarn install を実行し、依存するパッケージをインストールしておいてください。

以前は npm を使っていたのですが、GitHub からのパッケージの更新がなぜかかなり重いため、yarn に変更しました。パッケージのインストールは遅いですが、npm を使ってビルドすることもできます。

yarn dev でリッスンされる開発サーバーでは、コードすると自動的に差分が再ビルドされます。
API サーバーは別のポート (7000) でリッスンされているので、開発サーバーでのみ API のアクセス先を http://(サーバーと同じホスト名):7000/ に固定しています。

クライアントの静的ファイルは、client/dist/ に配置されているビルド済みのものをサーバー側で配信するように設定されています。
そのため、yarn build でクライアントのビルドを更新したのなら、サーバー側で配信されるファイルも同時に更新されることになります。

寄付・支援について

とてもありがたいことに私に寄付したいという方が複数いらっしゃったので、今のところ アマギフ (Amazon ギフト券) だけ受けつけています。

特典などは今のところありませんが、それでも寄付していただけるのであれば、アマギフの URL を Twitter の DM (クリックすると DM が開きます) か tvremoteplusあっとgmail.com まで送っていただけると、大変開発の励みになります…🙏🙏🙏

アマギフを送っていただく際に KonomiTV に実装してほしい機能を添えていただければ、もしかするとその機能を優先して実装することがある…かもしれません。
ただし、私個人のプライベートやモチベーション、技術的な難易度などの兼ね合いもあるため、『必ず実装する』とお約束することはできません。あくまで私からのちょっとしたお礼レベルなので、基本期待しないでいただけると…。

また、一応 Amazon のほしい物リスト もあります。 どのようなものでも贈っていただけると泣いて喜びます…。

このほか、こちら のリンクをクリックしてから Amazon で何かお買い物していただくことでも支援できます (Amazon アソシエイト)。
買う商品はどのようなものでも OK ですが、より 紹介料率 (商品価格のうち、何%がアソシエイト参加者に入るかの割合) が高く、価格が高い商品の方が、私に入る報酬は高くなります。Kindle の電子書籍や食べ物・飲み物は紹介料率が高めに設定されているみたいです。

もしかすると GitHub から Amazon に飛ぶとリファラチェックで弾かれてしまうかもしれないので、リンクをコピペして新しく開いたタブに貼り付ける方が良いかもしれません。

Special Thanks

• xtne6f さん： KonomiTV と EDCB を連携させるための実装や、tsreadex の実装の依頼・開発などで多大なご協力をいただきました。
• rigaya さん： QSVEncC・NVEncC・VCEEncC での動作オプションや不具合の対応、低遅延化改良、エンコードパラメーターのアドバイスなどを支援していただきました。また、rkmppenc の開発では多岐に渡り多大なご協力をいただきました。
• xqq さん： mpegts.js で MPEG-TS をダイレクトストリーミングできるようになり、わずか最短 0.9 秒の低遅延でテレビを視聴することができるようになりました。mpegts.js のヘルプやプレイヤーへの導入のサポートなども支援していただきました。
• monyone さん：aribb24.js のおかげで、ARIB 字幕や文字スーパーを完璧に表示できるようになりました。また、字幕関連のほか、iPhone 向けの LL-HLS ライブストリーミングの実装 やトラブルシューティング、導入のサポートなどで多大なご協力をいただきました。

KonomiTV の開発にあたり、ほかにも沢山の方からサポートやフィードバック、ご支援をいただきました。
この場をお借りして厚く感謝を申し上げます。 本当にありがとうございました！

License

MIT License