Install ffmpeg docker

Author: hovnatan

Dockerfile

@@ -10,7 +10,7 @@ ENV HOME /root
 WORKDIR $HOME
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
-  ca-certificates python3 python3-pip python3-venv libgl1-mesa-dev libglib2.0-0 libsm6 libxrender1 libxext6 nano vim htop && \
+  ca-certificates python3 python3-pip python3-venv ffmpeg libgl1-mesa-dev libglib2.0-0 libsm6 libxrender1 libxext6 nano vim htop && \
   rm -rf /var/lib/apt/lists/*
 
 RUN update-alternatives --install /usr/bin/python python /usr/bin/python3 1

docs/source/tutorial.sdk.rst

@@ -20,6 +20,13 @@ SDK is available on PyPI:
 The package officially supports Python 3.6+ and was tested under Linux and
 Windows (`Anaconda <https://www.anaconda.com/products/individual#windows>`_) platforms.
 
+For certain video related functions to work, ffmpeg package needs to be installed.
+It can be installed on Ubuntu with:
+
+.. code-block:: bash
+
+   sudo apt-get install ffmpeg
+
 For Windows and Mac OS based installations to use :py:obj:`benchmark` and :py:obj:`consensus`
 functions you might also need to install beforehand :py:obj:`shapely` package,
 which we found to work properly only under Anaconda distribution, with:

superannotate/db/projects.py

@@ -251,8 +251,10 @@ def upload_video_to_project(
                 "Frame rotation of %s found. Output images will be rotated accordingly.",
                 rot
             )
-    except Exception as e:
-        logger.warning("Couldn't read video metadata %s", e)
+    except:
+        logger.warning(
+            "Couldn't read video metadata to determine rotation. This could be because ffmpeg package is not installed. To install it, run: sudo apt install ffmpeg"
+        )
 
     video = cv2.VideoCapture(str(video_path), cv2.CAP_FFMPEG)
     if not video.isOpened():