Contents

• Terminology
• What is DumpTS?
• How to build?
• How to run it?
• Operations Manual
• References

Terminology

• TS: transport stream, the file extension is normally .ts, .tts, .m2ts, .mts
• ISOBMFF: ISO-based Media File Format, the file extension is normally .mp4, .mov, m4a, m4v, .m4s, .heif, .heic, .avif
• Matroska: a multimedia container format based on EBML (Extensible Binary Meta Language), the file extension is normally .mkv, .mka, .mk3d and .webm
• MMT: MPEG Media Transport stream, the file extension is normally .mmts
• PS: MPEG program stream, the file extension is normally .vob, .vro, .mpg, .mpeg
• NAL: Network Abstract Layer stream, the file extension is normally .h264, .avc, .h265, .hevc, h266 and .vvc
• MPV: MPEG video stream, the file extension is normally .mpv, .m2v, .mp2v, .m1v
• AV1: AV1 Open Bitstream with low-overhead or length-delimited(defined in Annex B of AV1) bitstream format, the file extension is normally .obu,.av1
• ADTS The elementary stream exported from MPEG2-AAC stream which is packetized in TS stream, the file extension is normally .adts
• LOAS/LATM The elementary stream exported from MPEG4-AAC stream which is packetized in TS or MMT/TLV stream, the file extension is normally .loas(with sync layer) or .latm, normally exported MPEG4-AAC as .loas

Top

What is DumpTS?

DumpTS is a simple utility tool to process the multimedia files packed into main-stream multimedia container formats, which provides these kinds of features:

• Extract and repack the elementary stream data or PSI sections data from TS, ISOBMFF, Matroska and MMT/TLV file
• List the primitives hierarchical elements or meta w or w/o filter, and show the syntax, semantic, payload hex-view, bit offset and count, and so on, then assist to look inside the media essential of any given media file
• Show media information of elementary streams(AC3/DD+/MLP/DTS/DTS-HD/MPEG2-AAC/MPEG-4 AAC/MPEG2 Video/H.264/H.265/AV1...), ISOBMFF box, Matroska EBML element and MMT/TLV and TS packet/message/table/descriptors, container layout, ...
• Re-factor a TS stream file in place
• Extract some elementary streams, and reconstruct a partial TS file
• Show decoder HRD model information for any codec stream, ATC/PCR/pts/dts and so on, and do the related verification
• Provide some utility features for ISOBMFF file reconstruction
• Provide some utility functions for codec and container technology, for example, Huffman Codebook, CRC, container layout...

Top

How to build?

• Windows
  
  1. VS2015/vc14
     Open build/DumpTS_vc14.sln and build it
     
  2. VS2017/vc15
     Open build/DumpTS_vc15.sln and build it
     
  3. VS2019/vc16
     Open build/DumpTS_vc16.sln and build it
     
• Linux
  
  Make sure gcc with modern C++11/14 support is installed
  Here are steps to build and install this application

  git clone https://github.com/wangf1978/DumpTS.git
  cd DumpTS/build/linux
  make
  cd ../../bin/linux/
  ./DumpTS --help
  

• MacOS
  
  Make sure clang with modern C++11/14 support is installed
  Here are steps to build and install this application:

  git clone https://github.com/wangf1978/DumpTS.git
  cd DumpTS/build/macos
  make
  cd ../../bin/macos/
  ./DumpTS --help
  

  (*) both 32-bit and 64-bit are supported

Top

How to run it?

Usage: DumpTS.exe [MediaFileName] [OPTION]...

The option parameter pattern is like as

--option_name=option_values

In the option, if one parameter value has multiple parts, each part can be delimited with the characters of .;,:. As for the detailed option syntax, please see Option Syntax.

Here are some examples of command lines:

• Show TS information

  DumpTS 00001.m2ts --showinfo
  Program Number: 103, program_map_PID: 0X1F0(496).
  Program(PID:0X01F0)
          Stream#0, PID: 0X0138, stm_type: 0X06 (Teletext, ARIB subtitle or TTML)
          Stream#1, PID: 0X0130, stm_type: 0X06 (Teletext, ARIB subtitle or TTML)
          Stream#2, PID: 0X0110, stm_type: 0X0F (AAC Audio)
          Stream#3, PID: 0X0100, stm_type: 0X02 (MPEG2 Video)
  
  Program(PID:0X01F0)
          Stream#0, PID: 0X0138, stm_type: 0X06 (Teletext, ARIB subtitle or TTML)
          Stream#1, PID: 0X0130, stm_type: 0X06 (Teletext, ARIB subtitle or TTML)
          Stream#2, PID: 0X0110, stm_type: 0X0F (AAC Audio)
          Stream#3, PID: 0X0100, stm_type: 0X02 (MPEG2 Video)
          Stream#4, PID: 0X0111, stm_type: 0X0F (AAC Audio)
  
  The number of transport packets: 9495552
          PID: 0x0000             transport packet count:     10,579 - PAT
          PID: 0x001E             transport packet count:          2 - DIT
          PID: 0x001F             transport packet count:      2,216 - SIT
          PID: 0x0100             transport packet count:  9,174,898 - MPEG2 Video
          PID: 0x0110             transport packet count:    131,186 - AAC Audio
          PID: 0x0111             transport packet count:    130,561 - AAC Audio
          PID: 0x0130             transport packet count:      1,153 - Teletext, ARIB subtitle or TTML
          PID: 0x0138             transport packet count:        222 - Teletext, ARIB subtitle or TTML
          PID: 0x01F0             transport packet count:     10,579 - PMT
          PID: 0x01FF             transport packet count:     29,568 - PCR
          PID: 0x1FFF             transport packet count:      4,588 - Null packet
  

  it will show the PAT and PMT informations of 00001.m2ts, and the packet count for each PID.

• Show TS elementary stream media and codec information

  DumpTS 00001.m2ts --pid=0x1100 --showinfo
  Dolby Lossless Audio (TrueHD/Atmos) Stream information:
          PID: 0X1100.
          Stream Type: 131(0X83).
          Sample Frequency: 192000 (HZ).
          Bits Per Sample: 24.
          Channel Layout: 5.1ch(L, C, R, Ls, Rs, LFE)@D-Cinema.
  

  It will show the elementary audio stream information, including channel layout, sample frequency and so on

• Show Box information

  DumpTS test.mp4 --trackid=1 --boxtype=stsd --showinfo
  

  Show the 'stsd' box information, for example, HEVC/AVC resolution, chroma, bit-depth and so on

• Show WebM media and codec information

  DumpTS av1.webm --showinfo
  

  Show the tree view for the EBML elements of av1.webm

• Show MMT/TLV container information

  DumpTS 00301.mmts --showinfo
  

  Show the MMT payload information, including PLT, MPT and asset/elementary information

• Dump ES stream from TS/M2TS file

  DumpTS 00001.m2ts --output=00001.hevc --pid=0x1011 --srcfmt=m2ts --outputfmt=es --showpts  
  

  It will dump a hevc es stream with PID 0x1011 from the m2ts stream file: 00001.m2ts, and print the PTS of every frame.

• Change the PID value for the specified ES

  DumpTS test.ts --output=00001.m2ts --pid=0x100 --destpid=0x1011 --srcfmt=ts --outputfmt=m2ts  
  

  It will re-factor the file: test.ts, and replace the PID 0x100 with 0x1011 in TS pack and PSI, and convert it to a m2ts

• Dump ES stream with PID and stream_id_extension from a TS/M2TS file

  DumpTS 00022.m2ts --output=00022.mlp --pid=0x1100 --srcfmt=m2ts --outputfmt=es 
  --stream_id_extension=0x72  
  

  It will dump a MLP sub-stream from 00022.m2ts with the PID 0x1100 and stream_id_extension in PES: 0x72

• Remove the specified MP4 Box(es)

  DumpTS test.mp4 --showinfo --removebox='unkn'
  

  Show the MP4 file box layout, and remove box with type 'unkn'

• Dump sample data of the specified track from MP4 stream

  DumpTS tes.mp4 --output=test.hevc --trackid=1 --outputfmt=es
  

  Dump the track#1 of test.mp4, and save its sample data to the file test.hevc with NAL annex-b byte stream format, the VSP, SPS and PPS will be merged into elementary stream data.

• Extract block data of the specified track from WebM file

  DumpTS tearsofsteel_4sec0025_3840x2160.y4m-20000.av1.webm --trackid=1 --output=tearsofsteel_4sec0025_4K.av1
  

  Extract av1 video stream from .webm file

• Show data fields of each TLV/IPv4/IPv6/MMT/message/table/descriptor/MPU/MFU

  DumpTS 00301.mmts --showpack
  

  Show the detailed information for MMT packets, payloads, messages, tables and descriptors

• Extract ES data from MMT/TLV file

  DumpTS 00301.mmts --CID=0 --pid=0x100 --output=e00301.hevc
  

  Extract the HEVC stream from header compressed IP packet with context_id: 0 and MMT packet id: 0x100 from 00301.mmts

Top

Operations Manual

• For MMT, please see MMT operation guideline
• For AV1/OBU, please see AV1/OBU operation guideline
• For Audio, please see Audio operation guideline
• For NAL, please see NAL bitstream operation guideline
• For Transport-Stream, please see TS bitstream operation guideline
• For ISOBMFF, please see ISOBMF media operation guideline
• For Matroska, please see Matroska media operation guideline
• Some utility features are also provided, please see Utility operation guideline
• Media Syntax Element Locator protocol, please see Syntax Element Locator protocol

Top

References

Please see References

Top