What is tuners.yml in Mirakurun?
The tuners.yml file is the main configuration file that tells Mirakurun which TV tuners are connected to your system, how many streams each can handle simultaneously, and which command to run to start streaming from each tuner. For chardev-based tuners, this file must be edited manually.
Where is tuners.yml Located?
/opt/mirakurun/config/tuners.yml
Basic tuners.yml Structure
Each tuner entry in tuners.yml follows this format:
- name: PT3-T0
types:
- GR
command: recpt1 --device /dev/pt3video0 <channel> - -
dvbDevicePath: ~
decoder: ~
isDisabled: false
Key Fields Explained
- name — A label for this tuner, for your reference
- types — GR for terrestrial, BS for satellite, CS for cable
- command — The shell command Mirakurun runs to start streaming; must accept channel and output as arguments
- dvbDevicePath — Set to the device path for DVB tuners; leave as ~ for chardev
- isDisabled — Set to true to temporarily disable a tuner without removing it
Example: Multiple Tuners
If you have a multi-tuner card like the PT3 or PX-Q3PE, add one entry per tuner slot:
- name: PT3-T0
types: [GR]
command: recpt1 --device /dev/pt3video0 <channel> - -
- name: PT3-T1
types: [GR]
command: recpt1 --device /dev/pt3video1 <channel> - -
- name: PT3-S0
types: [BS, CS]
command: recpt1 --device /dev/pt3video2 <channel> - -
After Editing tuners.yml
Restart the Mirakurun container to apply the changes:
docker compose restart mirakurun
Then check the admin UI at :40772 to confirm tuners are showing as connected.
Frequently Asked Questions
What recording command should I use for my tuner?▼
It depends on your tuner model. Common tools are recpt1 for PT series tuners and recdvb for other chardev tuners. Check your tuner's documentation for the correct command syntax.
How many streams can one tuner handle?▼
Most physical tuner cards support one stream per tuner slot simultaneously. Multi-tuner cards like the PT3 have multiple slots, each needing its own entry in tuners.yml.