Mirakurun

DVR Tuner Server for Japanese TV which designed for the "Air" (in development codename).

このforkについて

MMT/TLV対応のforkであり、EPGの収集、チャンネルスキャン、ロゴ収集、イベントid指定のストリーミングなどに対応しています。 サービス別のストリームについては現在1TLV1サービスで運用されており必要がないため実装しておらず、どのAPIでも無加工のTLVストリームが出力されます。 チャンネル種別にはBS4Kが追加されています。

MMT/TLVの解析はhttps://github.com/otya128/arib-mmt-tlv-tsを用いて実装しています。

設定

Linux上でhttps://github.com/otya128/tbs6812_drvとhttps://github.com/otya128/recdvbで動作を確認しています。

dvbv5-zapとdvbDevicePathの設定でも動作しますが、設定の管理が二重になりチャンネルスキャンもできないため推奨しません。

WindowsではBonRecTestで動く可能性はありますが動作は確認していません。

tuners.ymlの設定例:

- name: adapter0
  types:
    - GR
    - BS
    - CS
    - BS4K
  command: recdvb --dev 0 <channel> - -
- name: adapter1
  types:
    - GR
    - BS
    - CS
    - BS4K
  command: recdvb --dev 1 <channel> - -

複数のDVBデバイスを用いる場合は全てのモジュールパラメータにadapter_nr=<n>を指定してアダプタ番号が固定されるようにすることを推奨します。

起動後次のコマンドでチャンネルスキャンできます。 左旋を無効にする設定は未実装なため、受信できない場合は手動で無効にしてください。 (4518x, 4528x)

curl -X PUT "http://localhost:40772/api/config/channels/scan?type=BS4K&refresh=true"

追加機能

useTSId: trueをserver.ymlに設定すると相対TS番号の代わりにTSIDとデフォルトTSを使うようになるためBSとCSのチャンネルスキャンがすぐに終わるようになります。

TSIDによる指定に対応しているDVBデバイスと併用する場合は問題ありませんが、chardevチューナーと併用する場合はTSID指定に対応しているドライバと対応しているrecpt1を用いる必要があります。

• ドライバ
  • https://github.com/otya128/px4_drv
  • https://github.com/tsukumijima/px4_drv
• recpt1
  • https://github.com/otya128/recpt1

Docker

see: available Tags (Docker Hub)

Quick Install

mkdir ~/mirakurun/
cd ~/mirakurun/
wget https://raw.githubusercontent.com/Chinachu/Mirakurun/master/docker/docker-compose.yml
docker-compose pull
docker-compose run --rm -e SETUP=true mirakurun
docker-compose up -d

see: doc/Platforms.md

Features

• RESTful API (Open API) - has designed like HTTP version of Spinel
• Unix Sockets / TCP
• Advanced Tuner Process Management
• Priority Management
• Tuner Device Pooling
• Integrated MPEG-2 TS Parser, Filter
• Realtime EPG Parser
• Supports most Tuner Devices (chardev, DVB / ISDB-T, ISDB-S, DVB-S2)
• Channel Scan
• IPv6 Support
• Multiplexing Mirakuruns
• Web UI
• IPTV Server (M3U8 Playlist, XMLTV)

Figure: Variety of the MPEG-2 TS Stream API

Figure: Stream Flow

Requirements / Supported Platforms

• Node.js 14, 16, 18
• Linux w/ PM2 or Docker

see: doc/Platforms.md

Install / Update / Uninstall / CLI

see: doc/Platforms.md

Web UI

# Admin UI
http://_your_mirakurun_ip_:40772/

# Swagger UI
http://_your_mirakurun_ip_:40772/api/debug

PM2 Plus (Keymetrics)

You can use PM2 Plus to realtime monitoring if running by PM2.

• PM2 Plus (Keymetrics)

Client Implementations

• Rivarun
• BonDriver_Mirakurun
• Mirakurun Client (Built-in)
  • "Air" (in development codename)
  • Chinachu γ
  • EPGStation

Contributing

CONTRIBUTING.md

Supporting

• Tip4Commit (BTC) - to Every Committers
• Open Collective (USD) - Pool (TBD)

Discord Community

• Invitation: https://discord.gg/X7KU5W9

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

Copyright / License

© 2016- kanreisa.

• Code: Apache License, Version 2.0
• Docs: CC BY 4.0
• Logo: CC BY-SA 4.0

Commercial License / Support is provided by Pixely LLC.