文書は danything.github.io/denpa でも読めます。
チューナーを挿して起動すれば、そのまま使える自宅用のテレビ録画サーバです。 設定ファイルは書かず、チューナーは種別 (地上波 / 衛星) まで自動で見分け、あとは画面でスキャンを押すだけ。 Mirakurun や EDCB、メディアサーバは要りません。番組表から予約し、CM は自動で飛ばし、 ライブも録画もブラウザで字幕・データ放送つきで観られます。テレビは専用のアプリ denpa-tv で。
1.x から上げる人は 2.0 で変わったこと (画面の場所・無くなった設定) を先に。
 録画 — 予約と録画を 1 本の一覧に。サムネ付きで、押せばその場で観る |
 ライブ — 字幕もデータ放送も。止めれば追っかけ |
 観る — 放送どおりの字幕、CMは自動で飛ばす |
ほかの画面 (番組表・検索・ルール・設定) は docs/screens.md。
denpa は、自分の B-CAS カードで、自分の世帯の中で、私的に録画して観るためのものです。
- 録画やライブを、世帯の外の人に観せない
- カードの鍵を、世帯の外の機器に配らない
- カードを書き換えない
端末 (ブラウザ) が外のサービスに直接繋ぐのは、設定でオンにしたときの実況のコメントだけです。NX-Jikkyo とニコニコ実況 過去ログ API に繋ぎ、相手には端末の IP とどの局をいつ観ているかが見えます (docs/architecture.md)。 ライブでは NX-Jikkyo に書き込めます。書いたものは公開され、消せません (docs/watch.md)。
考え方は Discussion #760 にまとめています (法律相談ではなく、議論のための整理です)。
- 予約 — 番組表から押すか、検索から作るルールで自動で。同じ回は最初の放送だけ録る
- 録画 — CM を見つけてチャプターにし、AV1 / H.264 の mkv にエンコードする。字幕は放送の ARIB 字幕のまま入れる。Intel の GPU があれば使う
- ライブ — 放送から 1 秒ほどで。止めれば追っかけ、二カ国語・解説放送も選べる (docs/watch.md)
- データ放送 — テレビと同じ BML がブラウザで動く (d ボタン)。ライブでも録画でも
- 観る — 行を押せばその場で再生。CM は1コマも見せずに飛ばし、続きから・倍速 (×1〜×2)・切り抜き (字幕・コメントごとサーバに保存)
- 字幕と放送の字 — 字幕は放送どおりの位置に描き、番組名・局名も含めて Denpa Font で外字まで崩さない
- 端末に保存して観る — 電波の無いところでも (docs/offline.md)
- EPGStation・EDCB から引き継ぐ — ルール・予約・録画 (EDCB は録画の履歴) (docs/migrate.md)
- 別の機械へ移す — ルール・予約・録画の一覧・設定を書き出して、新しい機械の denpa に取り込む (docs/migrate.md)
部品はチューナーで選局して素の TS を流す チューナーエージェント と、それ以外の全部 (番組表・予約・録画・ エンコード・配信) をやる denpa の2つだけです (docs/architecture.md)。
チューナー・B-CASカードとカードリーダー・OS (Linux / Mac / Windows)・Docker (Windows は WSL) が要ります。使えるチューナーの一覧と細かいことは docs/tuners.md。
1行で、denpa 本体とチューナーのエージェントの両方が立ち上がり、ブラウザが開きます。 clone は要りません。
# Linux / Mac
curl -fsSL https://raw.githubusercontent.com/danything/denpa/main/install.sh | bash# Windows (PowerShell)
irm https://raw.githubusercontent.com/danything/denpa/main/install.ps1 | iexOS ごとの置き場、Compose を手で置くとき、上げ方と設定の書き場所は docs/install.md。
- http://denpa.localhost (Linux・Mac で genkan を入れられたとき) か
http://<IP>:3000(Windows は http://localhost:3000)。LAN のほかの機器 (テレビ・スマホ) からもhttp://<IP>:3000 - 誰を通すか — 設定するまで全部断ります。compose の
TRUSTED_NETWORKSの初期値は家の中 (私設網) で、 ここからはログインなしで通ります。範囲の変え方と、画面をログイン (OIDC) で守るときは docs/install.md - 設定の「受信」の「チューナー」で見つかったチューナーを確かめ、「チャンネル」でスキャンを押します (局が1つも無いうちは、録画・番組表・ライブの上に案内が出ます)。衛星は最初から局が入っていて、 地上波は十数分。終わると番組表を集めるので (数分)、あとは番組表から予約するだけです
- カードリーダーが NG のまま録ると、中身はスクランブルされたままです (設定の「受信」の「チューナー」に出ます)
1コンテナ (denpa-aio)・Helm・リバースプロキシの後ろに置くとき・困ったときは docs/install.md、
ログインの細かいことは docs/auth.md。
- ブラウザ — ホーム画面にも置ける (docs/watch.md)
- テレビ (Android TV / Fire TV) — denpa-tv。テレビに出る QR をスマホで読めば繋がる
- 外から使う API — 局・録画の一覧、ライブ、音声だけ (Home Assistant やスクリプト向け。docs/api.md)
はじめる
- docs/install.md — 立てる (入れ方の選択肢・1コンテナ・Helm・前段の後ろに置く)
- docs/install-mac.md — Mac に入れる
- docs/install-windows.md — Windows に入れる
- docs/install-talos.md — Talos Linux の 1 台に、OS の設定から 1 行で入れる (PT3。実機で確かめていない)
- docs/screens.md — 画面 (実機のスクリーンショット)
- docs/faq.md — よくある質問
- docs/v2.md — 2.0 で変わったこと
チューナー
- docs/tuners.md — 使えるチューナー (一覧・カードリーダー・B-CAS・直らないとき)
- docs/tuner-pt3.md — PT3 など (Linux DVB。実機で確かめていない機材も)
- docs/tuner-px4.md — PX-Q3U4・PX-W3U4・PX-MLT (px4-userland)
- docs/tuner-px-s1ud.md — PX-S1UD (siano-userland)
乗り換え
- docs/switch.md — ほかの録画ソフトから乗り換える (Mirakurun・EPGStation・KonomiTV・EDCB)
- docs/migrate.md — EPGStation・EDCB からの引き継ぎと、別の機械へ移す
使う
- docs/watch.md — 観る (ライブ・操作バー・ホーム画面に置く)
- docs/offline.md — 端末に保存して電波の無いところで観る
- docs/library.md — 録画の置き場と配り方 (テレビのアプリ・削除・通知)
運用
- docs/config.md — 環境変数 (一覧と、前のバージョンから上げるとき)
- docs/auth.md — 誰を通すか (OIDC・信頼したネットワーク・ペアリング)
外から使う
- docs/api.md — 外から使う API
仕組み
- docs/architecture.md — なぜこの作りなのか (決めたこと・踏んだ落とし穴・画面で動いてよいもの (CSP))
- docs/agent.md — チューナーエージェント (取り合い・共有・選局・設定ファイル・B25・鍵の配布)
- docs/data.md — エージェントに都度聞くもの / denpa が持つもの
- docs/stream.md — ライブの仕組み (経緯)
- docs/player.md — 観る画面の作り
- docs/encode.md — エンコード (字幕・AV1・GPU)
- docs/cm.md — CM 検出
- docs/logo.md — 局ロゴ (番組表の PNG と CM検出用に覚えたロゴ)
手を入れる
- docs/development.md — 手を入れるとき (開発環境・テスト)
- docs/app.md — どこに何があるか (ファイル・画面・状態遷移・テスト)
- docs/writing.md — 書き方 (画面・docs・コメントの言葉)
- docs/design.md — 見た目の決まり
- docs/licenses.md — 借りているもの
動いた/動かなかったを Issue で教えてもらえると助かります。
特別協賛:
@eggplants (haruna) さんが、GitHub Sponsors で denpa を大きく支えてくれました。本当にありがとうございます。
手を入れてくれた人 (ありがとうございます):
- @Khronos31 (#188)
- @unlimish (#431)
- @fetburner (#662)
- @sirius128 (#775)
- @chiroru27 (#1681 #1724)
報告や提案をくれた人 (ありがとうございます):
- @Khronos31 (#184 #195 #376 #377)
- @unlimish (#417)
- @kametani-mikihiro (#437 #471 #480 #481 #503 #505 #509)
- @fetburner (#668)
- @shino-zxc (#1210 #1713)
- @eggplants (#1617 #1709)
- @ogatomo21 (#1708)
土台にしている仕事:
- px4-userland / siano-userland (@Khronos31) — ホストにドライバを入れずにチューナーを使えるのはこれのおかげです。PX-MLT5PE / DTV02A-5TS-P の対応は @siketyan
AGPL-3.0-or-later (LICENSE)。ネットワーク越しに使わせる形で配るなら、その中身も同じ条件で 渡せるようにしてほしい、という理由で選んでいます。借りているもの (ffmpeg・Denpa Font ほか) は 元のライセンスのままで、一覧は docs/licenses.md。