Skip to content

Latest commit

 

History

History
215 lines (184 loc) · 10.3 KB

README.md

File metadata and controls

215 lines (184 loc) · 10.3 KB
Raw

Contents

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
      DumpTS Build
    2. VS2017/vc15
      Open build/DumpTS_vc15.sln and build it
      DumpTS Build
    3. VS2019/vc16
      Open build/DumpTS_vc16.sln and build it
      DumpTS Build
  • Linux
    DumpTS Build
    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
    DumpTS Build
    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

Top

References

Please see References

Top