LogoLogo
ForumCodeDonate
  • Introduction
    • About
    • Release / Change Log
  • Installation
    • Requirements
    • Tuners
    • Linux
    • Virtualisation - Proxmox
    • Docker
    • NAS
    • Android
  • SETUP
    • Stages
    • Concepts
    • Muxes/Scan Files
      • Scan Files
      • Using w_scan Scan Files
  • CONFIGURATION
    • Concepts
    • Electronic Program Guide
    • Digital Video Recorder
    • Web User Interface Customisation
      • Theme
      • Date/Time Format
  • HTTPS access via Reverse Proxy
  • APPENDICES
    • FAQ
    • CLI Commands
    • Debugging
  • Development
    • Compiling
      • Compiling TVH with VAAPI Support
        • for Lubuntu 24.04
        • for Lubuntu 22.04
        • Level 2
    • HTSP
      • General
      • HTSMSG Binary Format
      • Communication
      • Client to Server (RPC) methods
      • Server to Client methods
      • Protocol Changes
      • HTTP Proxy Examples
    • JSON API
      • API Description
        • Common Parameters
        • Access
        • Bouquet
        • Caclient
        • Channel
        • Codec
        • Config
        • DVR
        • EPG
        • EPGgrab
        • ESfilter
        • idnode
        • Input
        • intlconv/charsets
        • Language
        • MPEGts
        • Profile
        • RatingLabel
        • Raw
        • Satip
        • Service
        • Status
        • Timeshift
        • Tvhlog
      • Examples
      • Other Functions
      • WebSocket
    • Object Class Relationships
    • Testing Tuners Using Files
    • Translations
    • Programmers Translation Workflow
    • XMLTV
      • Input
        • Recognised Tags/Attributes
        • Episode Numbering
      • Output
    • Object ID Representation
    • WebUI Help Content Workflow
    • Random Notes
  • Creating a Mux Dump
  • WIP
    • Release / Change Log Mockup
  • Release / Change Log 2
Powered by GitBook

© Tvheadend 2006-2024

On this page
  • Introduction
  • Performing a Mux Dump
  • Finding the UUID
  • WebUI Methods
  • Creating the Mux Dump
  • Transferring the Mux Dump

Was this helpful?

Export as PDF

Creating a Mux Dump

PreviousRandom NotesNextRelease / Change Log Mockup

Last updated 1 month ago

Was this helpful?

Introduction

A 'Mux Dump' is a special recording where Tvheadend records the entire transmission of a single broadcaster rather than just a specific channel. Mux dumps can be useful for .

For most purposes, a mux dump lasting between 1 and 2 minutes should be suitable, however, if you are requested to provide a mux dump, ask the requester to indicate how long the mux dump should be for their purposes.

Performing a Mux Dump

In order to perform a mux dump, you first have to obtain the UUID of the mux that you wish to dump. The is a block of text, 32 characters long, containing only numbers and lower case letters.

Finding the UUID

WebUI Methods

There are many ways to do this, however, one of the easiest is to use the WebUI to navigate to 'Configuration - DVB Inputs - Muxes'. For each mux listed, there will be a 'Play' icon, on the left side of each row.

The process will be different between specific browsers, however, the 'Play' icon will always point to a link that contains the UUID of the mux somewhere.

  • Simply moving your mouse cursor over this icon should show the link destination, containing the mux UUID, somewhere in the browser window.

  • Right-clicking on the icon and selection 'Copy link' (or similar) should place some text into your clipboard that contains the UUID. For example: http://<TVH_IP>:9981/play/ticket/stream/mux/176838fd011c233adfa42d8a07f9ddba?title=177.5MHz%20%2F%20DVB-T%20Network Using this method, the UUID is '176838fd011c233adfa42d8a07f9ddba' can can be located between '/mux/' and the question mark.

  • Also, right-clicking on the icon and selecting 'Save link as' (or similar) should provide you with a prompt for a file name. The default file name provided by your browser should contain the UUID of the mux. For example: d32ef9ef9c67e0552465f6a86caf1d77.m3u Using this method, the UUID is 'd32ef9ef9c67e0552465f6a86caf1d77' and consists of all of the characters before the '.m3u' in the file name.

  • If you already receiving functioning services from the mux in question, you can navigate to 'Configuration - DVB Inputs - Services', select one of those functioning services and press the 'Edit' button. Within the edit window, press the 'Read-only Info' drop-down button and copy the value shown in the 'Mux UUID' text box. Press 'Cancel' to close the edit window.

API Direct Method

http://<TVH_IP>:9981/api/mpegts/mux/grid

This list will contain all muxes, enabled and disabled, successfully tuned or not. Each JSON object will represent one mux. You will need to search through this list for the mux on the frequency that you seek and then take note of the UUID associate with that frequency.

Creating the Mux Dump

VLC

If you already have VLC configured as your default m3u application, simply click on the 'Play' icon described above and once VLC starts, press the 'Record' icon in VLC. Manually stop the recording after the required duration has elapsed.

Even if VLC is not your default m3u application, you can still use VLC by opening the 'Media - Open Network Stream' and pasting the link to the mux that you wish to dump as follows:

http://<TVH_IP>:9981/stream/mux/<MUX_UUID>

Hint: If you used the 'Copy link' method described above, you can simply paste that link directly into the 'Network URL' requested by VLC.

Linux Command Line - curl

The following curl command will dump 90 seconds of the specified mux.

curl -m 90 http://<TVH_IP>:9981/stream/mux/<MUX_UUID> > sample_file.ts

Linux Command Line - wget

The following wget command initiate a dump of the specified mux. However, the dump will have to be manually stopped using CTRL-C when the required time has elapsed.

wget http://<TVH_IP>:9981/stream/mux/<MUX_UUID> -O sample_file.ts

Transferring the Mux Dump

A mux dump file is normally too large to email or post to the forum. It is up to the requester and user to agree a method for transferring the file. There are, however, several free peer-to-peer file transfer options to choose from.

A list (in JSON format) of all muxes known to the system can be obtained by issuing the following command:

development and debugging purposes
UUID
API