Home

Awesome

EDCB-Wine

Screenshot

Windows 向けの予約録画ソフトである EDCB を、Wine を使って Linux 上で動作させるための Docker Compose 構成一式です。

事前に Docker コンテナ上に Xfce / X11VNC / noVNC をセットアップしているため、ブラウザから Xfce の軽量 Linux デスクトップにリモートアクセスし、すぐに EpgTimerSrv の各種設定や EpgDataCap_Bon でのチャンネルスキャンを行えます。

さらに EDCB Material WebUI (EMWUI) を組み込んでいるため、ブラウザから EDCB の設定・予約・録画などを行えます。
また、KonomiTV のバックエンドとしても利用できることを確認済みです。

「Wine 使うってゲテモノじゃね？」と感じる方もいるかもしれませんが（私も試作するまではそう思っていました…）、若干の注意点こそあるものの、魔法のように安定して動作します。
EDCB のチューナーバックエンドとして Mirakurun / mirakc を利用する構成になっているため、すでに Mirakurun + EPGStation 環境を構築済みの方でも比較的簡単に導入できるはずです。

Core i5-9400 の環境では常時コア全体の CPU 使用率が 1% 以下で、メモリ使用量も 500MB 前後と、デスクトップ環境まで入っている割にはかなり軽量といえるのではないでしょうか。
このリポジトリでは設定や動作確認向けにブラウザから操作可能なデスクトップ環境を用意していますが、EDCB は（設定を除けば）デスクトップ環境がなくても EpgTimerNW や EDCB Material WebUI からリモート操作が可能なため、デスクトップ環境をオミットすれば、より軽量なコンテナにできるはずです。

予約録画も単発予約・EPG 予約ともに問題なく動作することを確認済みです。
まだ長期テストはできていませんが、十分実用に耐えうるレベルだと思います。

Usage

1. 動作確認環境

EDCB の動作環境である Wine からは直接 Linux ホストマシン上に接続されているチューナーハードにアクセスできないため、Mirakurun or mirakc / BonDriver_mirakc を併用し、ホストマシン上のチューナーを Mirakurun / mirakc 経由で利用する構成となっています。
そのため、ホストマシン上で Mirakurun or mirakc がセットアップ済みで、すでに稼働していることが前提となります。

[!NOTE]
BonDriver_mirakc は BonDriver_Mirakurun の上位互換のようで、Mirakurun でも問題なく動作します (Mirakurun でのみ動作確認済み) 。
BonDriver_mirakc に限らず、チューナーをネットワーク越しに利用する仮想 BonDriver であればなんでも使えるはずです。

EDCB-Wine の構成には、3つの BonDriver_mirakc が含まれています。
いずれも dll 自体は全く同一のものですが、Mirakurun / mirakc に登録しているチューナーを EDCB に正確に把握させるために用意しています（詳細は後述）。

2. 事前準備

2.1. EDCB-Wine のリポジトリのクローン

まず、このリポジトリをクローンしてください。
配置フォルダはどこでも構いませんが、一般的には /opt/ 以下が無難だと思います。

$ git clone https://github.com/tsukumijima/EDCB-Wine.git
$ cd EDCB-Wine

EDCB の動作環境一式 (EDCB Material WebUI 含む) は既にこのリポジトリの EDCB/ フォルダに同梱されているため、別途構築する必要はありません。

[!NOTE]
同梱の EDCB は DTV-Builds にて公開している EDCB のビルド済みアーカイブのうち、EDCB-231229 (64bit) をベースに Wine 環境では不要 or 動作しないファイルを除外・調整したものになります。
本来 Git のバージョン管理にバイナリファイルを含めるのはあまり良くないのですが、EDCB を構成する各ファイルを適切にバージョン管理したかったため、このような形になりました。

Wine 環境からは、EDCB の実行ファイルや設定ファイル群は Z:\EDCB (Docker コンテナ側: /EDCB) としてマウントされています。
ファイル内容はデスクトップ環境内のファイルマネージャーから確認できます。

2.2. ホストマシンに接続されている HDD のマウント設定

ホストマシンに接続されている HDD を Wine 環境内の EDCB から利用するには、別途設定が必要です。

$ cp wine-mount.example.sh wine-mount.sh

wine-mount.sh には、ホストマシンに接続されている HDD のマウント設定を記述します。
wine-mount.example.sh からコピーして作成した wine-mount.sh を編集し、各自の環境に合わせて調整してください。

[!NOTE]
マウント対象のホストマシン側のフォルダは /mnt/ 配下に配置されている必要があります。
これは、Docker Compose 構成でホストマシン上の /mnt/ を Docker コンテナ上の /mnt/ にマウントしているためです。

[!NOTE]
.wine64/dosdevices/ 配下に d: のようなドライブレターの名前のシンボリックリンクを配置することで、リンク先のフォルダを Wine 環境にドライブとしてマウントできる Wine の機能を利用して実装しています。

たとえば、下記の環境で Wine 環境上の D: ドライブに /mnt/hdd-record/ をマウントする際は、wine-mount.sh に次のように追記します。

ln -s "/mnt/hdd-record/" "d:"

[!NOTE]
複数の HDD が /mnt/ 配下にマウントされている場合は、wine-mount.sh にそれぞれの HDD のマウント設定を追記してください。
その際、ドライブレターが HDD 間で重複しないように注意してください。
なお、Wine 側で予約されているため、ドライブレターに C: と Z: は利用できません。

あとは EpgTimerSrv や EpgDataCap_Bon の設定 UI で録画フォルダに D:\TV-Record を指定すれば、EDCB で録画した録画ファイルをホストマシン上の HDD に永続的に保存できます。
もちろん、/mnt/hdd-record/ 配下のほかのフォルダにも D:\ 以下からアクセスできます。

[!WARNING]
wine-mount.sh に記述したフォルダ以外に保存しようとすると、docker compose down でコンテナを停止・削除したときに録画ファイルも一緒に消えてしまうため、十分注意してください。

2.3. 設定ファイルのコピー

EDCB/ フォルダには、

の4つのサンプル設定ファイルが同梱されています（私が実際に使っている設定データをベースに EDCB-Wine 向けに細かく調整したもの）。

$ cp EDCB/Common.example.ini EDCB/Common.ini
$ cp EDCB/EpgDataCap_Bon.example.ini EDCB/EpgDataCap_Bon.ini
$ cp EDCB/EpgTimerSrv.example.ini EDCB/EpgTimerSrv.ini
$ cp EDCB/RecName/RecName_Macro.dll.example.ini EDCB/RecName/RecName_Macro.dll.ini

サンプル設定ファイルは（フォルダパスなど環境依存の項目以外は）追加の設定変更なしでそのまま予約録画ができるように調整されています。
コンテナが起動した後に一から EpgDataCap_Bon や EpgTimerSrv の設定を行うこともできますが、こだわりがなければこの *.example.ini を *.ini にコピーして使うことをおすすめします。

なお、設定ファイルを保存する際は、文字コードや改行コードに十分注意してください。
誤った文字コードや改行コードで保存すると、EDCB が正常に動作しなくなる可能性があります。

各設定ファイルの文字コードや改行コードは次のとおりです。ファイルごとに文字コードが異なるため特に注意が必要です。

[!NOTE]
このサンプル設定ファイルでは、ホストマシン上の録画フォルダが /mnt/hdd-record/TV-Record 、録画情報フォルダ (*.ts.program.txt / *.ts.err が保存される) が /mnt/hdd-record/TV-RecordInfo にそれぞれ作成されている前提で作成されています。
*.ini をコピーした後に手動で設定ファイルを編集するか、コンテナ起動後に EpgTimerSrv の設定 UI を開き、それぞれ録画環境にあわせて変更してください。

[!NOTE]
ホストマシン上の録画フォルダのパーミッションは、万が一の権限周りのトラブルを回避するため、777 (drwxrwxrwx) に設定することをおすすめします。
基本 755 などでも問題はないとは思いますが、念のため…。

[!NOTE]
もしサンプル設定ファイルを使わず一から設定を行う場合、デフォルトの状態では EDCB Material WebUI は動作しないほか、KonomiTV のバックエンドとしても利用できません。
EpgTimerSrv の設定 UI から、手動でネットワーク接続や HTTP サーバー機能を有効にする必要があります。
EDCB を KonomiTV のバックエンドとして利用する場合は、KonomiTV の当該ドキュメント も参照してください。

3. Docker イメージのビルド・コンテナの起動

以下のコマンドを実行して Docker イメージをビルドし、コンテナを起動します。

[!NOTE]
ビルド後の Docker イメージのサイズは 4.5GB 弱あります。
Wine と Xfce の動作環境が入っている関係で若干大きめです（これでも頑張って減らした方…）。

$ docker compose up -d --build

ビルドが完了すると、すぐに EpgTimerSrv (EpgTimer Service) が起動します。
EpgTimerSrv は、Docker コンテナの起動中は常時起動されるように設定されています。

[!NOTE]
デスクトップ画面のタスクトレイから EpgTimerSrv を終了すると、Supervisor の autorestart 設定により、再度 EpgTimerSrv が起動されます。
この挙動を利用すると、EpgTimerSrv の設定変更を即座に反映したい場合に、Docker コンテナを再起動することなくすぐに変更後の設定を反映できます。

[!WARNING]
docker compose stop で Docker コンテナを停止する際、EpgTimerSrv は強制終了されてしまうようです (終了後にデバッグログが突然途切れる) 。
本当は Graceful に終了できる状態が理想ではありますが、Wine 上で稼働していることもあり難しそうです。
本来は行われるであろう終了時処理もおそらく行われないため、Docker コンテナを停止する際は、可能であれば一度タスクトレイから EpgTimerSrv を終了してから docker compose stop を実行した方がより安全だと思われます。

4. EDCB の設定

ブラウザで http://<ホストマシンのIPアドレス>:6510 にアクセスすると、Docker コンテナ内で稼働している Xfce のデスクトップ画面を Web ブラウザから操作できます！
別途操作側のデバイスに VNC や RDP のクライアントをインストールする必要はありません。

この Xfce のデスクトップ環境は軽量化のため、EDCB 本体（ホストマシン側からマウントされている）、日本語入力用の Fcitx5-mozc 、ファイルマネージャー、タスクマネージャー、ターミナル、設定 UI 以外のアプリは一切インストールされていません。
EpgTimerSrv / EpgDataCap_Bon の動作確認と UI 操作が行える、最低限の GUI 環境となっています。

[!NOTE]
英数字と日本語の入力切り替えは、Ctrl (Control) + Space で行えます。
おそらく noVNC 側の問題で全角/半角キーが反応しないため、IME 切り替えはこの方法で行ってください。

4.1. EpgDataCap_Bon の起動とチャンネルスキャン

Screenshot

デスクトップ左側の EpgDataCap_Bon のアイコンをクリックすると、EDCB の録画用アプリである EpgDataCap_Bon を起動できます！
初回起動時は「チャンネル情報の読み込みに失敗しました」と表示されますが、これからチャンネルスキャンを行うため問題ありません。

[!NOTE]
EpgTimerSrv (EpgTimer Service) が予約録画タスクを司る EDCB のコアとなるデーモンプロセスで、EpgDataCap_Bon は録画開始時や EPG 取得時に自動で EpgTimerSrv から起動・制御される、録画用アプリという位置づけです。
このため、受信確認・チャンネルスキャン・設定以外では、EpgDataCap_Bon を手動で起動する機会はあまりありません。
EpgDataCap_Bon 単体で録画することもできますが、EDCB Material WebUI or EpgTimerNW (後述) から行う方が便利で安全です。
EpgTimer は EpgTimerSrv サーバーのフロントエンド (C# 製) で、テレビ予約録画サーバーとしての EDCB は EpgTimerSrv と EpgDataCap_Bon だけで動作します。

まずはチャンネルスキャンを行いましょう。
チャンネルスキャンが行われていないと、EpgTimerSrv は配置された BonDriver を認識できません。

BonDriver_mirakc.dll をちゃんとオープンできる (EpgDataCap_Bon のウインドウに Signal の値が表示される) ことを確認してから、チャンネルスキャンを開始してください。

[!WARNING] この段階では、BonDriver_mirakc_T.dll / BonDriver_mirakc_S.dll のチャンネルスキャンは行わないでください。

地デジ・BS・CS のすべてのチャンネルをスキャンするため、スキャンの完了までには10分ほど時間がかかります。
なお、深夜にチャンネルスキャンを行うと、停波中のチャンネルがスキャン結果から漏れてしまいます。できるだけ日中に行うようにしてください。

[!NOTE]
EpgDataCap_Bon で BonDriver_mirakc.dll のオープンに失敗した場合は、ホストマシン上で Mirakurun / mirakc が起動していないか、何らかの要因でうまく接続できていない可能性が高いです。
ホストマシン上で稼働しているサーバーとの通信を容易にするために network_mode を host に設定しているため、Docker コンテナからだけアクセスできなくなることはないはずです。
デスクトップ環境のターミナルから wget -O - http://localhost:40772/api/version と実行して、Mirakurun / mirakc にアクセスできるか確認してみてください。

[!NOTE]
通常の BonDriver では受信感度としてそのまま dB 値が表示されますが、BonDriver_mirakc では Mirakurun / mirakc のアーキテクチャ上受信感度が取得できないため、代わりに TS ストリームのビットレート (Mbps 単位) が表示されるようです。

チャンネルスキャンが終わったら、EpgDataCap_Bon の設定 UI を確認しておきましょう。
録画フォルダ設定は EpgTimerSrv と共通 (Common.ini) なので、ここで設定する必要はありません (もちろんここでやっておいても OK) 。

ステップ 2 で事前にサンプル設定ファイルをコピーしてある場合は、特に設定変更をしなくてもそのまま動作するはずです。
もし変更したい項目があれば適宜設定してください。

[!NOTE]
まったく BS / CS の有料放送を視聴しない場合は、EpgDataCap_Bon の設定 → [EPG取得設定] / [サービス表示設定] から、BS / CS の有料放送を EPG 取得の対象から除外しておくと便利です。

EpgDataCap_Bon で BonDriver_mirakc.dll のチャンネルスキャンが完了すると、下記の2つのチャンネル設定ファイルが作成されます。

ChSet5.txt は、EDCB に登録された BonDriver 全体で受信可能なチャンネルを記述したチャンネル設定ファイルです。
一方 *.ChSet4.txt は、各 BonDriver ごとに受信可能なチャンネルを記述したチャンネル設定ファイルになります。

[!NOTE] ChSet4.txt / ChSet5.txt ともにフォーマットは TSV で、文字コードは UTF-8 with BOM 、改行コードは CRLF です。
手動で編集する際は、文字コード・BOM・改行コードの3点に十分注意してください。
以下では便宜上 nano で編集するコマンド例を載せていますが、個人的には VS Code (Remote-SSH) での編集を推奨します。

つまり、BonDriver_mirakc_T.dll 用の ChSet4.txt には地上波のチャンネル情報のみを、BonDriver_mirakc_S.dll 用の ChSet4.txt には BS・CS のチャンネル情報のみを記述するようにすることで、当該 BonDriver を地上波 or BS・CS 専用の BonDriver として認識されるように構成できます。

[!WARNING]
EpgDataCap_Bon で直接 BonDriver_mirakc_T.dll / BonDriver_mirakc_S.dll のチャンネルスキャンを行うと、地上波・BS・CS のすべてのチャンネルが当該 BonDriver 用の ChSet4.txt に記述されてしまうため、地上波専用 / 衛星専用の BonDriver として認識されなくなってしまいます。注意してください。

ここでは、以下の手順を踏み、それぞれ地上波専用 / 衛星専用の BonDriver として認識されるようにします。

  1. BonDriver_mirakc(BonDriver_mirakc).ChSet4.txt をそれぞれコピー
  2. BonDriver_mirakc_T.dll 用の ChSet4.txt から BS・CS チャンネルが記述された行を削除
  3. BonDriver_mirakc_S.dll 用の ChSet4.txt から地上波チャンネルが記述された行を削除

[!NOTE]
もし Mirakurun / mirakc に PLEX PX-MLT5PE や e-better DTV02A-4TS-P といった地上波/衛星共用のマルチチューナーしか登録していないのであれば、この手順はスキップしても構いません。

# ChSet4.txt をコピー
$ cp -a "EDCB/Setting/BonDriver_mirakc(BonDriver_mirakc).ChSet4.txt" "EDCB/Setting/BonDriver_mirakc_T(BonDriver_mirakc).ChSet4.txt"
$ cp -a "EDCB/Setting/BonDriver_mirakc(BonDriver_mirakc).ChSet4.txt" "EDCB/Setting/BonDriver_mirakc_S(BonDriver_mirakc).ChSet4.txt"

# 手動で ChSet4.txt を編集 (保存を忘れずに)
# 前述の通り文字コード・BOM・改行コードに十分注意すること
$ nano "EDCB/Setting/BonDriver_mirakc_T(BonDriver_mirakc).ChSet4.txt"
$ nano "EDCB/Setting/BonDriver_mirakc_S(BonDriver_mirakc).ChSet4.txt"

4.2. EpgTimerSrv の起動と設定

Screenshot

EpgTimerSrv の設定 UI は、画面右上のタスクトレイを右クリック → [システム] → [Srv設定] から表示できます！

ステップ 2 で事前にサンプル設定ファイルをコピーしてある場合は、以下の項目のみ、環境に合わせて変更してください。

サンプル設定ファイルで既にある程度設定を済ませてあるため、それ以外の設定変更は基本的に不要です（適宜お好みで調整してください）。

録画保存フォルダ / 録画情報保存フォルダは、wine-mount.sh に記述したドライブレター (D:\ など) のルートフォルダか、そのサブフォルダに設定してください。
前述の通り、wine-mount.sh に記述したフォルダ以外に保存しようとすると、docker compose down でコンテナを停止・削除したときに録画ファイルも一緒に消えてしまいます。十分注意してください。
なお、録画情報保存フォルダ未指定時は、録画情報が録画ファイルと同じフォルダに保存されます。

チューナー数は、必ず Mirakurun に登録しているチューナーの数と種類 (地上波専用 or 衛星専用 or 地上波/衛星共用) に合わせて割り当てる必要があります。
さもなければ、EDCB が正確にチューナー数を把握できず、複数チャンネルを同時録画する際に正常に録画できない可能性があります。

EPG 取得に利用するチューナー数は、最低でも、利用可能な BonDriver ごとに 1 以上の EPG 取得用チューナーを割り当てる必要があります。
EPG 取得に利用するチューナー数をすべて 0 にすると、EPG 取得が行われなくなってしまいます。
一般的には、BonDriver ごとにチューナー数の半分くらいがベストです。

例として、PLEX PX-Q3U4 (地上波チューナー×4 + 衛星チューナー×4) と e-better DTV02A-1T1S-U (マルチチューナー×1) を Mirakurun に登録している環境では、上記のように設定します。

PLEX PX-MLT5PE (マルチチューナー×5) のみを Mirakurun に登録している環境では、上記のように設定します。
チューナー数を 0 に設定すると、その BonDriver は事実上無効化されます。

4.3. EpgTimerSrv の設定変更の反映 / 注意事項

設定が終わったら、一旦 EpgTimerSrv をタスクトレイから終了してください。
前述したようにすぐに EpgTimerSrv が再度起動され、変更後の設定が反映されます。

[!WARNING]
ごくまれにですが、デスクトップをクリックしてもソフトが起動しなくなったり、起動した場合も × ボタンで終了できなくなったりすることがあります。
同時に x11vnc が謎に再起動していることが関係しているようですが、今のところ原因は不明です。
なお、この問題が起きた際の EDCB への動作の影響はありません。UI こそフリーズしたような状態になりますが、予約録画や EPG 取得は正常に行われます。
発生間隔はランダムため、まったく発生しないこともあります。もしこの問題が発生した際は、Docker コンテナを再起動してみてください（その際、録画中でないかをしっかり確認してください）。
docker compose exec edcb-wine /bin/bash でコンテナに入り、Xvfb のプロセスを kill することでも対処できます。ただし、起動中の EpgTimerSrv や EpgDataCap_Bon はいずれにせよ強制終了されてしまうようなので、コンテナを再起動するのとさほど変わりません。

[!WARNING]
なお、EpgTimerSrv の UI だけフリーズしている場合は、Mirakurun への接続失敗や停波中などでの受信エラーによる BonDriver_mirakc のフリーズが、EpgDataCap_Bon 経由で伝搬している可能性が高いです。
このとき、EpgDataCap_Bon はウインドウの表示処理が行われる前段階でフリーズしてしまっているため UI ウインドウが表示されていませんが、タスクマネージャーからは起動中のプロセスとして確認できます。
もしこの状況に陥った場合は、録画中でなければ Docker コンテナごと再起動することを強く推奨します。

なお、EpgTimer に関しては、Wine-mono を使えば動作はすると思われるものの、

を考慮し、対応を見送りました。

4.4. EpgTimerNW の設定 (任意)

Screenshot

Windows PC から EpgTimer を使い、EDCB-Wine で稼働中の EpgTimerSrv をリモート操作することもできます。
DTV-Builds で公開している EDCB のビルド済みアーカイブから EpgTimer.exe を入手したあと EpgTimerNW.exe にリネームして、適当な場所に新規作成したフォルダに移動してください。

その後 EpgTimerNW.exe を起動すると、EDCB-Wine で稼働中の EpgTimerSrv にリモート接続できます！
EpgTimerSrv のサーバー環境設定以外は、Windows 上で EDCB を使う際と同じように予約操作や設定を行えます。

番組改編期などで大量の EPG 予約追加/削除を一括で行いたいケースでは、EDCB Material WebUI より EpgTimerNW の方が便利です。

5. EDCB Material WebUI にアクセス

Screenshot

ブラウザで http://<ホストマシンのIPアドレス>:5510/EMWUI/epg.html にアクセスすると、EDCB Material WebUI の Web 画面が表示されます！

初回起動時のみ EPG 取得が全く行われていないため、番組表には何も表示されていないか、不完全な状態になっています。
サンプル設定ファイルでは、毎日 06:15 と 18:15 に定期的に EPG 取得を行うように設定しています。

<img width="50%" src="https://github.com/tsukumijima/EDCB-Wine/assets/39271166/56420d4f-5b14-4107-b1e4-0708f19d08bc"><br>

すぐに EPG 取得を行いたい場合は、番組表ページ右上のメニューから「EPG 取得」をクリックしてください。
EPG 取得対象に設定したすべてのチャンネルの EPG 取得が開始されます。

EPG 取得完了にはかなり時間がかかります。
EPG 取得が完了すると、すべてのチャンネルの番組表が表示されるはずです。

Screenshot

基本操作は Windows での EDCB Material WebUI と同じです。
ただし、テレビのリモート視聴 / 録画ファイルのストリーミングのみ、Wine 環境では Lua からの外部コマンド実行が正しく動作しない (?) ため、あえて動作しない状態にしています。

EpgTimer でできることの大半は EDCB Material WebUI でも行えます。
番組表からの予約追加や検索など、EPGStation 同様かそれ以上の操作性で、PC・スマホを問わず利用できるのが特徴です。

[!NOTE]
前述のとおり、EDCB-Wine で稼働している EDCB は KonomiTV のバックエンドとしても利用できます。
テレビのライブストリーミングでは、代わりに KonomiTV を利用することをおすすめします（手前味噌）。録画視聴機能は鋭意開発中なのでしばしお待ちを…。

License

MIT License