録画サーバー(TV録画サーバー)を構築するためのスクリプト・設定を1つに集約したリポジトリです。 チューナードライバのインストールから Mirakurun / mirakc + EPGStation の構築まで、複数の方式をまとめて管理します。
もともと以下の4リポジトリに分かれていたものを、構築方式ごとに整理して集約しています。
各方式の詳細ドキュメントは docs/ にまとめています。
| ディレクトリ | 旧リポジトリ | 役割 | ドキュメント |
|---|---|---|---|
drivers/ |
rec-cmd-install | チューナードライバ・録画コマンド (px4_drv / recpt1 / libaribb25) のインストール(全方式共通) | docs/drivers.md |
native-install/ |
mirakurun-epgstation-install | Mirakurun + EPGStation をネイティブ(直接)インストールするシェルスクリプト & 設定 | docs/native-install.md |
ansible/ |
rec-server-script-dev | 上記を Ansible でまとめて自動構築(ネイティブ方式の自動化) | docs/ansible.md |
docker/ |
mirakc-epgstation-px-x1ud | mirakc + EPGStation + MySQL を Docker で構築(Docker方式) | docs/docker.md |
録画サーバーの構築には大きく2系統あります。用途に応じて選択してください。手順の詳細はいずれも docs/ を参照してください。
- A. ネイティブ / Ansible 方式 … ホスト上に直接インストール。手動なら
drivers/→native-install/の順にスクリプトを実行、一括自動構築ならansible/の Playbook を実行します。(docs/drivers.md / docs/native-install.md / docs/ansible.md) - B. Docker 方式 … mirakc + EPGStation + MySQL をコンテナで構築。ホストにはドライバのみ必要です。(docs/drivers.md / docs/docker.md)
- OS: Ubuntu Server 20.04
| Name | URL |
|---|---|
| px4_drv | https://github.com/nns779/px4_drv |
| libaribb25 | https://github.com/tsukumijima/libaribb25 |
| recpt1 | https://github.com/stz2012/recpt1 |
| Mirakurun | https://github.com/Chinachu/Mirakurun |
| mirakc | https://github.com/mirakc/mirakc |
| EPGStation | https://github.com/l3tnun/EPGStation |
- バージョンはルートの
VERSIONファイルで管理します。 VERSIONを更新してmainに push すると、GitHub Actions がv<バージョン>タグと GitHub Release(リリースノート自動生成)を作成します。- リリース手順:
VERSIONを書き換える → コミット →mainへ反映。
- Dependabot (
.github/dependabot.yml): GitHub Actions と mirakc 用 Dockerfile のベースイメージを毎週チェックします。 - Mergify (
.github/mergify.yml): Dependabot の PR をコンフリクトが無ければ自動マージします。マージ後のブランチ削除は GitHub の「Automatically delete head branches」設定に任せます。
MIT License の下で公開しています。なお各ドライバ・ソフトウェア本体(px4_drv / recpt1 / Mirakurun / mirakc / EPGStation など)は、それぞれの上流リポジトリのライセンスに従います。
ansible/の各ロール(roles/rec_cmd,roles/mirakurun)は、集約済みのdrivers//native-install/を直接参照します(playbook_dirからの相対パス)。旧リポジトリのgit cloneは不要です。なお、チューナードライバ本体(px4_drv/libaribb25/recpt1)のソースは各インストールスクリプト内で上流からgit cloneされます。.gitignoreは各ディレクトリに個別のものを残しつつ、ルートにも共通パターンを集約した.gitignoreを用意しています。
