3 unstable releases
0.2.1 | Jul 29, 2024 |
---|---|
0.2.0 | Jun 7, 2024 |
0.1.0 | Jun 3, 2024 |
#120 in Video
21 downloads per month
63KB
980 lines
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
Dependencies
~1MB
~23K SLoC