ナマケモノの家
目的
本プログラム(raspirec) は Linux 系OS上で、
recpt1/recdvb,epgdump を使って TV番組を録画する録画サーバーを構築するための
録画予約システムです。
特に、ラズパイのようなシングルボードコンピュータ(SBC)で動作させる事に最適化しています。
なお動作には recpt1/recdvb に対応しているドライバーがあるTVチューナー ( アースソフト社製 PT1〜3, PLEX社製 PX-W3U4、PX-W3PE4、PX-Q3U4、PX-Q3PE4 等) が必要です。
| チューナーカード名 | ドライバー | デバイスファイル | 録画コマンド |
|---|---|---|---|
| PT1, PT2 | pt1_drv | /dev/pt1video0 | recpt1 |
| PT3 | pt3_drv | /dev/pt3video0 | |
| Plex社製 PX-Q3U4 等 | px4_drv | /dev/px4video0 | |
| PT1, PT2, PT3 | earth_pt1,earth_pt3 | /dev/dvb/adapter0/frontend0 | recdvb *1 |
*1 : recdvb は本家のものではなく recpt1互換の recdvb を使用します。
特徴
- Raspberry Pi のようなシングルボードコンピュータ(SBC)でも実行できるように、 機能はシンプルで小型、軽量。
- 処理能力の低いPCでも動作するように最適化。
- 同時録画本数を多くする為に録画中はなるべく負荷を掛けない。 (raspbery Pi 3B+ で 6本までは確認)
- インストールが容易
- WEBインターフェースで、EPG番組表から録画予約が可能。
- 条件検索を設定することで、自動予約登録が可能。
- 録画したTSファイルを、親機にコピーする機能
- チューナーの数とは別に、同時録画の本数で制限を掛ける事が可能。 (SBCの場合、能力不足により本数制限が必要になる。)
- Ver1.1.0 から PX-MLT8PE のような 3波(地デジ/BS/CS)チューナーも使用可
- Ver1.2.0 から 独立した GUIで「mpv モニタ機能」が使える raspirecTV をリリース
- Ver1.3.0 から 録画中の番組延長に対応 ( 詳細はこちら)
スクリーンショット
Top画面  |
番組表 |
予約状況表  |
番組検索  |
mpvモニタ(1)  |
mpvモニタ(2)  |
* mpvモニタ(2)は raspbery Pi 3B+ に接続された PX-Q3U4 の映像を親機のdesktopに表示
hlsモニタ  |
raspirecTV  |
実行に必要な環境
- Linux系 OSが稼働するPC と OS (ドライバーさえあれば UNIX系なら何でも可)
- ruby 2.5 以上
- sqlite3
- TVチューナー ( recpt1/recdvb のドライバーが存在するもの )
- recpt1 ( https://github.com/stz2012/recpt1 ) 又は recdvb ( https://github.com/kaikoma-soft/recdvb ) を推奨
- epgdump ( https://github.com/Piro77/epgdump を推奨 )
- もし b25 デコードするなら b25 ライブラリ + カードリーダー
制限事項
-
jquery,Materialize を参照しているので、 インターネットにアクセス出来る環境で動作させる事が必要。 だたし、あらかじめ参照ファイルをダウンロードして置けばオフラインでも動作させる事ができる。 (doc/jquery_local.md を参照 )
-
セキュリティにはあまり考慮していないので、インターネット側から アクセス出来る状態にしないで下さい。
インストール方法 ( Raspbian buster lite の場合 )
-
インストールに必要な下記のパッケージを apt install で インストールする。
- git
- autoconf
- raspberrypi-kernel-headers
- dkms
- cmake
- sqlite3
- ruby
- ruby-sqlite3
- ruby-sys-filesystem
- ruby-net-ssh
- ruby-sinatra
- ruby-slim
- ruby-sass
-
recpt1/recdvb
ハードに合わせたドライバーをインストールし、 コマンドラインから実行して録画出来る事を確認しておく。
-
epgdump
epgdump は、同じ名前で仕様の違うものがあるので、 必ず https://github.com/Piro77/epgdump を使う。
-
raspirec ( 基本機能のみ、オプション機能は 別紙を参照 )
-
インストールするディレクトリに移動して
% git clone https://github.com/kaikoma-soft/raspirec.gitすると raspirec というディレクトリが出来るので、 それを以下 $BaseDir とする。
-
環境に合わせて configファイルをカスタマイズ
-
雛形の config.rb.sample を $HOME/.config/raspirec/config.rb にコピー
-
コピーした config.rb をテキストエディタを使って、 自分の環境に合わせるように修正する。 とりあえず最低限必須なのは次のもの。詳細は doc/config.md を参照
Recpt1_cmd : recpt1 コマンドの path を指定する。 Epgdump : epgdump コマンドの path を指定する。 BaseDir : raspirec がインストールされているディレクトリを設定する。 ( raspirec.rb があるディレクトリ ) DataDir : データベースや録画したファイルの置き場所を指定する。 GR_EPG_channel : 地デジ EPG 受信局を設定する。 GR_tuner_num : 地デジチュナー数 BSCS_tuner_num : BSCSチュナー数 GBC_tuner_num : 地デジ/BS/CS チューナー数 -
configファイルを $HOME/.config 以外の任意の場所に置きたい場合は、 環境変数 RASPIREC_CONF に絶対パスで指定して下さい。
-
-
テスト実行
% ruby ${BaseDir}/raspirec.rb -f一度フォアグラウンドで実行し、エラーが出ない事を確認する。 エラーメッセージがでなければ、Ctrl-C で中止する。
-
-
実行方法
% ruby ${BaseDir}/raspirec.rbでデーモンモードで起動する。
すぐに終了するが、バックグラウンドでサービスは走っているので、 WEBブラウザ で http://ホスト名:4567/ でアクセスする。 ( ポート番号の 4567はデフォルトの値で、config で変更可)なお、OS の boot時に、自動で起動させたい場合は crontab に
@reboot /usr/bin/ruby ${BaseDir}/raspirec.rbを記述する。
-
停止方法
% ruby ${BaseDir}/raspirec.rb --killで、デーモンが停止する。
アンインストール方法
- ディレクトリ BaseDir, DataDir 以下のファイルを削除
- インストールしたパッケージを apt remove で削除
動作確認環境
| その１ | その２ | その３ | |
|---|---|---|---|
| 機種 | raspberry pi 3B+ | AMD Ryzen 7 2700 + MEM 16G | ← |
| OS | Raspbian Stretch | Ubuntu 20.04.2 LTS | ← |
| TVチューナー | PX-Q3U4 | PT2 | ← |
| ドライバー | px4_drv | pt1_drv | earth_pt1 |
| 録画ソフト | recpt1 | recpt1 | recdvb |
Docker を使ったテスト環境
Docker を使ったテスト環境を用意しましたので、 簡単に動作テストをする事が出来ます。
追加機能の説明
- hls, mpv モニタ機能の設定方法 (ver0.5.0 以降)
- パケットチェック機能の説明 (Ver1.0.0 以降)
- 独立GUI mpvモニタ raspirecTV の説明 (Ver1.2.0 以降)
- 録画自動延長機能の説明 (Ver1.3.0 以降)
リンク
- recpt1
- recdvb
- epgdump
- px4_drv
- PLEX社 Linux用ドライバー
- ナマケモノの家 raspirec
- gitHub raspirec
- gitHub Pages raspirec
不具合報告
不具合報告等は、gitHub の issues の方にお願いします。
ライセンス
このソフトウェアは、Apache License Version 2.0 ライセンスのも とで公開します。詳しくは LICENSE を見て下さい。