Skip to content

A simple Python 3 class for reading Azure Kinect DK MKV files, derived from vi/mkvparse

Notifications You must be signed in to change notification settings

rajkundu/Azure-Kinect-MKV-Reader

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 

Repository files navigation

Azure Kinect MKV Reader

A class for reading Azure Kinect DK MKV files in Python 3

Benefits:

  • Runs nearly universally – reads file byte-by-byte, does NOT depend on the Azure Kinect SDK

Limitations:

  • No "seek"/"skip" support
    • I think this could be implemented? I just don't need it, so I didn't implement it. Please contact me or file an issue to discuss!
  • No current IMU data support...
    • This is actually very easy to implement but was removed for convenience of defining a "frameset": Azure Kinect DK image data occurs only once per Matroska cluster, but IMU data occurs several times, so it was decided to just ignore IMU data for now to simplify things. However, the data is there and readable. Please contact me or file an issue if you'd like discuss adding support for reading IMU data!

Usage

from mkv_reader import MKVReader, TRACK

# Initialize MKVReader object
reader = MKVReader("./recording.mkv")
calib = reader.get_calibration()

while True:
  try:
    frameset = reader.get_next_frameset()
  except EOFError:
    break

  # Use frameset...
  color_img = frameset[TRACK.COLOR]

Please see example.py for a more detailed example!

Contributions

Any feedback and/or contributions are extremely welcome! :)

License

License = MIT

About

A simple Python 3 class for reading Azure Kinect DK MKV files, derived from vi/mkvparse

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%