Open source package for extracting and parsing telemetry associated with video streams and converting to common formats.
Project description
Open Telemetry Kit
The Open Telemetry Kit (OTK) is an open source package for extracting and parsing telemetry associated with video streams and converting to common formats. It comes out of a need for a singular API that can be used for multiple different video telemetry formats.
Telemetry that can be parsed includes: GPS, time, camera information, speed
Features:
- Automatically detect telemetry format
- Manipulate telemetry with ease
- Write telemetry to a new format
Getting Started
Prerequisites
Python version: >=3.6
ffmpeg
and ffprobe
.
On Debian systems these can be installed with:
$ sudo apt install ffmpeg
dateutil
On Debian systems this can be installed with:
$ pip install python-dateutil
Installation
$ pip install open-telemetry-kit
Importing
The OTK package can be imported into your project with:
import open_telemetry_kit as otk
Quick Start
Download quickstart.py
and DJI_telemetry.srt
from the Open Telemetry Kit git page.
Execute the script via:
$ python3 quickstart.py [/path/to/source/DJI_telemetry.json] [/path/to/save/destination.json]
The script accepts a standalone .csv
or .srt
or a video file with an embedded .srt
.
It will read in the data, convert it to JSON, and write it to the provided destination.
Note: this process will create a metadata.json
file in the same path as the source file.
If the telemetry is embedded it will also extract the data into [video_name].json
Current Functionality
Input Formats
The OTK currently supports the following forms of telemetry:
.csv
files.srt
files- Any video file with embedded telemetry encoded as a
.srt
(e.g. video taken with some DJI drone models)
Output Formats
- JSON
Future Releases
Planned expansions and updates for the OTK include:
Input Formats
.kml
.gpx
- KLV/MISB embedded data
Output Formats
- geoJSON
Other
- Logging
- Error checking
- Unit Tests
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for open_telemetry_kit-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5a173c2aa92ae2688bdddf4f2a27b05d39a137e3d7b110e68ac7ebfa50e3cd84 |
|
MD5 | 25258f9c143ec070dd5c2f216937483e |
|
BLAKE2b-256 | f6caf03d3b070e1bc1a3b937d654905fbd0488029ca1b458eeaaeda6089be4bd |