grimoutlook / ts-analyzer

A simple library for analyzing packets in MPEG/Transport Stream files.

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");
    let buf_reader = BufReader::new(f);
    // 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(&filename, buf_reader).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

ts-analyzer's Issues

Adaptation field skipping

It appears that there is a bug in the code to skip over an adaptation field (if present). You read the field length and then increment the read_idx by that value. However, you need to skip over one more byte in order to accommodate the length field itself. So, line 70 of packet.rs should be:
read_idx += af.adaptation_field_length() as usize + 1;

Would you like me to submit a merge request or would you prefer to just make that small change?