ts-analyzer

A library used for analyzing MPEG/Transport Stream files. This library is not intended for encoding, decoding or multiplexing transport streams. It has mainly been created for KLV extraction using klv-reader.

Example

extern crate ts_analyzer;

use std::env;
use ts_analyzer::reader::TsReader;
use std::fs::File;
use std::io::BufReader;

fn main() {
    env_logger::init();
    let filename = env::var("TEST_FILE").expect("Environment variable not set");
    println!("Reading data from {}", filename);

    let f = File::open(filename.clone()).expect("Couldn't open file");
    // Reader must be mutable due to internal state changing to keep track of what packet is to be
    // read next.
    let mut reader = TsReader::new(BufReader::new(f)).expect("Transport Stream file contains no SYNC bytes.");

    let mut packet;
    loop {
        println!("Reading packet");
        // Run through packets until we get to one with a payload.
        packet = reader.next_packet_unchecked() // Read the first TS packet from the file.
                       .expect("No valid TSPacket found"); // Assume that a TSPacket was found in the file.

        if packet.has_payload()  {
            break
        }
    }

    let payload = packet.payload();
    assert!(payload.is_some(), "No payload in packet");
    println!("Payload bytes: {:02X?}", payload.unwrap().data());
}

Goals

• Parse transport stream packets
  • Parse transport stream packet header
  • Parse transport stream packet adaptation field
  • Parse transport stream packet adaptation extension field
  • Be able to dump raw payload bytes from packet
• Parse complete payloads from multiple packets
  • Track packets based on PID
  • Concatenate payloads of the same PID based on continuity counter

Reference Material

• A sample TS stream with KLV data can be found here.
• Wikipedia: MPEG Transport Stream
• MPEG Official Documentation