Skip to main content

A simple and efficient wrapper for reading videos as NumPy tensors.

Project description


Build Status Code Style Platform

Reading videos as NumPy arrays was never more simple. This library provides an entire range of additional functionalities such as custom frame selection, frame resizing, pixel normalization, grayscale conversion and much more.


Getting started

1. Read a video, given its path

# Import
from mydia import Videos

# Initialize video path
video_path = r".docs/examples/sample_video/bigbuckbunny.mp4"

# Create a reader object
reader = Videos()

# Call the 'read()' function to get the video tensor
# which will be of shape (1, 132, 720, 1280, 3)
video =

The tensor can be interpreted as:

  • 1 video
  • Having 132 frames,
  • Dimension (width x height) of each frame: 1280x720 pixels
  • 3 denotes that the video is in RGB format

2. You can even use multiple workers for reading the videos in parallel

from mydia import Videos

video_paths = [

reader = Videos()
video =, workers=4)

3. View detailed examples here


  • Python 3.x (preferably from the Anaconda Distribution)

  • FFmpeg: The backend for reading and processing the videos.

    The recommended (and probably the easiest) way of installing FFmpeg is via the conda package manager.

        conda install -c mrinaljain17 ffmpeg

    However, if you are not using conda, then

    For Linux users -

        $ sudo apt-get update
        $ sudo apt-get install ffmpeg

    For Windows or MAC/OSX users -

    Download the required binaries from here. Extract the zip file and add the location of binaries to the PATH variable.


  1. Using the conda package manager (recommended):

        conda install -c mrinaljain17 mydia
  2. Using pip:

        pip install mydia

The following python packages that mydia depends on, will also be installed, along with their dependencies.


Copyright 2018 Mrinal Jain.

Released under the MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mydia-2.2.1-py3-none-any.whl (9.2 kB) Copy SHA256 hash SHA256 Wheel py3
mydia-2.2.1.tar.gz (9.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page