Mirakurun Guides

Everything You Need to Know About Mirakurun

Step-by-step guides covering setup, Docker deployment, tuner configuration, troubleshooting, and advanced tips for all Mirakurun users.

📡

What is Mirakurun? A Complete Beginner's Guide

New to Mirakurun? This guide explains what Mirakurun is, how it works as a Japanese digital TV tuner API server, and why it's the go-to middleware for home server setups in Japan.

🐳

How to Install Mirakurun Using Docker – Step by Step

The easiest way to run Mirakurun is via Docker. This guide walks you through pulling the official image, running the setup wizard, and getting your TV tuner server live in under 5 minutes.

⚙️

How to Configure Mirakurun Tuners.yml for Chardev Tuners

Using a Japanese chardev-based TV tuner? This guide shows you exactly how to write your tuners.yml file, set up a startup script, and get Mirakurun detecting your hardware correctly.

🔌

How to Connect Mirakurun with Chinachu DVR

Mirakurun and Chinachu are built to work together. Learn how to point Chinachu at your Mirakurun API, configure recording rules, and start your home DVR setup from scratch.

🔒

How to Set Up B-CAS Smart Card (pcscd) with Mirakurun

Watching encrypted Japanese broadcast channels requires B-CAS card support. This guide covers pcscd setup, common conflict fixes, and how to mount the socket correctly in Docker.

🖥️

How to Use Mirakurun Admin UI and Swagger API Explorer

Mirakurun includes a built-in web admin panel and Swagger UI. This guide shows how to access them, monitor tuner status, test API endpoints, and manage channels without touching the command line.

🔧

Mirakurun Troubleshooting – Fixing the Most Common Errors

Tuner not detected? Admin UI not loading? pcscd conflicts? This troubleshooting guide covers the most frequently reported Mirakurun issues with clear, tested solutions for each problem.

🚀

How to Run Mirakurun on Raspberry Pi – Complete Guide

Running Mirakurun on a Raspberry Pi is possible but needs extra steps. Learn how to build missing DVB kernel modules, configure Docker on Raspberry Pi OS, and optimize performance on low-power hardware.

Ready to Set Up Mirakurun?

Download Mirakurun free and follow our guides to get your TV tuner server running today.

Download Mirakurun Free →