Chinachu/Mirakurun

これは何？

主な機能

• 01Swagger / OpenAPI 2.0でドキュメント化されたHTTP RESTful APIを提供します。
• 02チューナープロセスを管理し、1回のチューニングから複数のストリームを出力できます。
• 03クライアント間のストリーム優先度を設定できます。
• 04MPEG-2 TSストリームとリアルタイムのEPGデータを解析します。
• 05チャンネルを自動スキャンします。
• 06M3U8プレイリストとXMLTVを提供するIPTVサーバーを備えています。

ユースケース

• Linuxサーバー上で、日本のデジタル放送向けの家庭用DVRやTV録画バックエンドを稼働させる。
• ローカルネットワーク上のIPTVクライアントに、ライブTVと番組表データを配信する。
• 1枚のチューナーカードを複数のクライアントアプリケーションで共有する。
• チューナーサーバーをDockerコンテナ内にデプロイする。

クイックスタート

1. 1

   Docker Hub から Docker イメージ chinachu/mirakurun を pull します

2. 2

   Setup Guide（doc/Platforms.md）に従ってチューナーデバイスを設定します

使う前に知っておきたいこと

• !日本のデジタル TV チューナー向けに作られているため、対応するチューナーハードウェアがないとほとんど役に立ちません。
• !セットアップの対象は Linux と Docker で、README には Windows や macOS での手順がありません。
• !セットアップにはチューナーデバイスの設定が必要で、詳しい手順は別のドキュメントに記載されています。

収録されている特集

トピック

よくある質問

Mirakurun とは？

LinuxやDocker上で日本のデジタルTVチューナーを管理し、ストリーム、EPG、IPTVプレイリストを提供するTypeScript製APIサーバー。 Mirakurunは、日本のデジタルTVチューナー機器を制御し、HTTP API経由で利用できるようにするサーバーです。チューナー機器とクライアントアプリケーションの間にミドルウェアとして配置し、チューナープロセスを管理することで、複数のクライアントが1つのチューニングを共有できるように設計されています。

Mirakurun は無料で使えますか？ライセンスは？

Mirakurun は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

Mirakurun は今もメンテナンスされていますか？

活発にメンテナンス中。Mirakurun の最終コミットは 2026年11月6日 です。

Mirakurun は何に使えますか？

Linuxサーバー上で、日本のデジタル放送向けの家庭用DVRやTV録画バックエンドを稼働させる。 ローカルネットワーク上のIPTVクライアントに、ライブTVと番組表データを配信する。 1枚のチューナーカードを複数のクライアントアプリケーションで共有する。 チューナーサーバーをDockerコンテナ内にデプロイする。

Mirakurun のインストール方法は？

Docker Hub から Docker イメージ chinachu/mirakurun を pull します Setup Guide（doc/Platforms.md）に従ってチューナーデバイスを設定します

Mirakurun はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Chinachu/Mirakurun