README.md

dvbrouter

Proxy and manager of mumudvb instances

Introduction

Forwarding DVB signal to a network can be done thanks to tools like Mumudvb. Following the documentation, one instance of it allows to retrieve the channels of one multiplex.

To broadcast additional channels that are on another multiplex, tutorials recommends to use a dual channel DVB receiver and to start another process of the same software. This case works if the system has as many tuners as multiplexes to use.

To avoid having to choose between multiplexes, this project has been created:

• It creates a playlist of channels on startup from a group of configuration files,
• It starts automatically mumudvb instances once a client opens a request to one the channel present in the playlist,
• It forwards the client to the stream once ready,
• It closes the process when no more clients watch an existing multiplex.

Configuration

The configuration file can be found in config/app.json.

{
  "version": 1,
  "server": {
    "port": 3001, // Port to listen to
    "routes": { "cors": true },
    "labels": ["socket"]
  },
  "mumudvb": {
    "host": "rapberrytv.local",
    "path": "../config/multiplexes/", // Folder where configuration files are stored
    "channels": 2, // Number of tuners available on the system
    "filters": [
      "ADULT"
    ]
  },
  "storage": {
    "destPath": "/mnt/Storage/records/"
  }
}

Installation for production

npm run build
npm run serve

The user running this project will be the owner of the mumudvb processes. It must run with a user that belongs to the video group or root.

Routes

GET: /

When the project is ready to receive requests, the root page will great you with a successful message.

GET: /status

This endpoints provides some details about the channels that have ben scanned.

GET: /playlist

Download the playlist in M3U format

GET: /stream/<ID>

Start the streaming of a given channel (ID to be found in the playlist).

Development

npm run start

Any change in the project will restart dvbrouter.