gpmf

Parser and Writer for GoPro Metadata Format (GPMF)

WIP: Currently successfully parses all raw test data and logs the results.

Design Goals

Linux Philosophy, each tool does one thing and does it well
Can be integrated in other tools, and in other languages than Rust
Focus on clean, easy to understand code (no macros)
Performant (but not at the expense of the previous item)
Easy to read detailed log in order to be able to debug problems
Memory safe parser
Zero security vulnerabilities. Avoid problems found in other tools e.g.: GoPro GPMF-parser Vulnerabilities
Never generate exceptions, i.e.: Should never panic.
Should pass fuzz tests i.e.: handle corrupt or junk data
Should avoid DOS attacks. Possibly Add max buffer lengths.
Gracefully recover from errors
Handle unknown tags
Roundtrip sensor data (without loss of precision or changing data type)

Reporting Issues

If you have a file that is not handled please submit an issue, attaching the raw metadata file

Feature Roadmap

Parser (WIP) at present just prints out data
Create a structure to hold data
Handle Scale
Handle multiple sensor data 'mp4 boxes/atoms', as contained in mp4 file
Return data in chronological order using Iterator and Tournament Tree
Extract metadata from Live Stream via WiFi and Rtmp Url in realtime
Handle exif data in images
Writer
Roundtrip sensor data

Example

use std::path::Path;
use gpmf::byteorder_gpmf::parse_gpmf;

fn main() -> anyhow::Result<()> {
    let path = Path::new("samples/karma.raw");
    let text = std::fs::read(path)?;
    let res=parse_gpmf(text.as_slice())?;
    println!("{:?}",res);
    Ok(())
}

Example with Logging

use std::path::Path;
use gpmf::byteorder_gpmf::parse_gpmf;
use tracing::Level;
use tracing_subscriber::FmtSubscriber;

fn main() -> anyhow::Result<()> {
    let subscriber = FmtSubscriber::builder()
        .with_max_level(Level::DEBUG)
        .finish();
    tracing::subscriber::set_global_default(subscriber)?;

    let path = Path::new("samples/Fusion.raw");
    let text = std::fs::read(path)?;
    let res=parse_gpmf(text.as_slice())?;
    println!("{:?}",res);
    Ok(())
}

License: MIT OR Apache-2.0

apps4uco/gpmf

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages