Skip to main content

Analysers

Analysers​

These are not part of MistServer itself, and are not needed for the software to operate. They are utilities meant to assist in development and/or debugging and can provide information about media streams of varying types. They share a common usage syntax and most of them can handle both stream and file input. Most users will not need to touch these under normal conditions, but they can be very useful to developers

The analysers also play a role when using MistServer load testing capabilities and in some cases can reconstruct a stream out of segmented or live only protocols for easier debugging purposes. Almost all MistAnalysers are made to work with files, though some can handle direct stream urls as well.

Detail level​

It's important to note that the detail level is somewhat unspecified. Unless a specific range is specified the default detail levels will go from 0-10. Where 0-5 are increased text information and 6-10 are generally (raw) data analysis.

Analysers run the same code as MistInputs​

If you run into problems with a specific input and the debug information isn't immediately helpful it's a good idea to try an analyser. The analysers run the same code as the inputs, so it should run in the same problems with more detailed information available.

Validate mode​

Every analyser will try to analyse as much of the stream as possible by default. However if --validate or -V mode is passed then it will stop at the first problem encountered and report. Validate mode is off by default, so it can be handy to be aware of this setting.

Using the analysers​

All analysers can work with files, whether that are actual video files or captures. Some can work with URLs or standard in. Generally it is assumed you have some knowledge about how streaming data works when you're using the analysers. Almost every analyser has a default that should give you a good impression of how the stream data flows. Taking MistAnalyserTS as an example would show the Program Association Table (PAT) and Program Mapping Table (PMT) of the MPEG-TS stream.

  [Program Association Table]
    Pointer Field: 0
    Table ID: 0
    Sectionlen: 13
    Transport Stream ID: 0
    Version Number: 0
    Current/Next Indicator: 1
    Section number: 0
    Last Section number: 0
    Programs [1]
      [1] Program Number: 1, Program Map PID: 480
    CRC32: 76F1A4CE
[PID 480|0: 184b PMT] [Start]
  [Program Mapping Table]
    Pointer Field: 0
    Table ID: 2
    Section Length: 61
    Program number: 1
    Version number: 0
    Current next indicator: 1
    Section number: 0
    Last Section number: 0
    PCR PID: 481
    Program Info (0):
      Stream 481: HEVC video (36)
        Undecoded descriptor: 380D0220000000900000000000991F
        Undecoded descriptor: 3F0F037F7F0000EA60019BFCC0000003E9
      Stream 482: ADTS audio (15)
        Language: und
    CRC32: 37F96972

As well as stream flow data such as the PES

[PES 482] [Audio 0] [Aligned] [Copy] [PTS 1.083s] [Size 177] [Payload 163]
[PES 481] [Video 0] [Aligned] [Copy] [PTS 1.751s] [DTS 1.667s] [Size 6 => 330621] [Payload 330602]
tip

For tips on what to look for per analyser please visit the analyser pages separately!

List of MistAnalysers​