https://github.com/chinachu/mirakurun

A Japanese digital TV tuner API server specifically designed for "Air"
https://github.com/chinachu/mirakurun

chinachu client dtv dvb dvr epg isdb javascript linux middleware mirakurun openapi server typescript

Last synced: 9 days ago
JSON representation

A Japanese digital TV tuner API server specifically designed for "Air"

• Host: GitHub
• URL: https://github.com/chinachu/mirakurun
• Owner: Chinachu
• License: apache-2.0
• Created: 2015-04-04T19:58:21.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2025-04-06T10:30:09.000Z (16 days ago)
• Last Synced: 2025-04-10T00:24:46.563Z (13 days ago)
• Topics: chinachu, client, dtv, dvb, dvr, epg, isdb, javascript, linux, middleware, mirakurun, openapi, server, typescript
• Language: TypeScript
• Homepage: https://chinachu.moe
• Size: 2.16 MB
• Stars: 660
• Watchers: 70
• Forks: 111
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Mirakurun](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/8e08d3d91390794b139ed593e3a834a8b41f651c/logo-mirakurun_2025-03-29.svg)](https://github.com/Chinachu/Mirakurun)

# Mirakurun

A Japanese digital TV tuner API server specifically designed for "Air" (code name of the app in development).

[![npm version][npm-img]][npm-url]

[![npm downloads][downloads-image]][downloads-url]

[![Linux Build][azure-pipelines-img]][azure-pipelines-url]

[![tip for next commit](https://tip4commit.com/projects/43158.svg)](https://tip4commit.com/github/Chinachu/Mirakurun)

[![Backers on Open Collective](https://opencollective.com/Mirakurun/backers/badge.svg)](#backers)

[![Sponsors on Open Collective](https://opencollective.com/Mirakurun/sponsors/badge.svg)](#sponsors)

[**CHANGELOG**](CHANGELOG.md) | [**Setup Guide**](doc/Platforms.md) | [**Configuration**](doc/Configuration.md)

[**English**](README.md) | [**日本語**](README.ja.md)

## Docker

[![dockeri.co](https://dockeri.co/image/chinachu/mirakurun)][docker-url]

Reference: List of available [tags](https://hub.docker.com/r/chinachu/mirakurun/tags) (Docker Hub)

## Features

- HTTP RESTful API (Swagger / Open API 2.0)

- Advanced tuner process management

- Multiple stream broadcasting from a single tuning

- Stream priority

- MPEG-2 TS parser, filter

- Real-time EPG parser

- Support for various tuner devices and hybrid environments (chardev, DVB / ISDB-T, ISDB-S, DVB-S2)

- Automatic channel scanning

- Web UI

- IPTV server (M3U8 playlist, XMLTV)

#### Figure: Variety of the MPEG-2 TS Stream API

![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/7409e229648e00b55404f9e8342dccb58bbb4ac4/mirakurun-fig-api-variety2.svg)

#### Figure: Stream Flow

![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/7409e229648e00b55404f9e8342dccb58bbb4ac4/mirakurun-fig-flow-stream2.svg)

## Setup Guide

👉 [**Setup Guide**](doc/Platforms.md)

## Configuration

👉 [**Configuration**](doc/Configuration.md)

## Web UI

```sh

# Admin UI

http://_your_mirakurun_ip_:40772/

# Swagger UI

http://_your_mirakurun_ip_:40772/api/debug

```

## Client Implementations

- [Rivarun](https://github.com/Chinachu/Rivarun)

- [BonDriver_Mirakurun](https://github.com/Chinachu/BonDriver_Mirakurun)

- Mirakurun Client ([Built-in](https://github.com/Chinachu/Mirakurun/blob/master/src/client.ts))

  - "Air" (in development codename)

  - [Chinachu γ](https://github.com/Chinachu/Chinachu/wiki/Gamma-Installation-V2)

  - [EPGStation](https://github.com/l3tnun/EPGStation)

## Contributing

- [CONTRIBUTING.md](CONTRIBUTING.md)

## Donations

- [Tip4Commit](https://tip4commit.com/github/Chinachu/Mirakurun) (BTC) - Distributed to all committers

- [Open Collective](https://opencollective.com/Mirakurun) (USD) - Pool (purpose undecided)

## 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](https://opencollective.com/Mirakurun#backer)]



## Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/Mirakurun#sponsor)]





















## Copyright / License

© 2016- [kanreisa](https://github.com/kanreisa).

- Code: [Apache License, Version 2.0](LICENSE)

- Docs: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)

- Logo: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)

[npm-img]: https://img.shields.io/npm/v/mirakurun.svg

[npm-url]: https://npmjs.org/package/mirakurun

[downloads-image]: https://img.shields.io/npm/dm/mirakurun.svg?style=flat

[downloads-url]: https://npmjs.org/package/mirakurun

[azure-pipelines-img]: https://dev.azure.com/chinachu/Mirakurun/_apis/build/status/Chinachu.Mirakurun?branchName=master

[azure-pipelines-url]: https://dev.azure.com/chinachu/Mirakurun/_build/latest?definitionId=1&branchName=master

[docker-url]: https://hub.docker.com/r/chinachu/mirakurun