====== ffprobe - Video - Rotate ======

To detect whether videos are recorded in portrait or landscape mode.


===== Video orientation detection =====

<code bash>
ffprobe -v error -select_streams v:0 -show_entries stream_tags=rotate -of csv=s=x:p=0 input.mp4
</code>

<WRAP info>
**NOTE:**  On unrotated videos, the above command produces no output.
</WRAP>

----

==== Getting Width, Height, Rotation ====

<code bash>
ffprobe -v error -select_streams v:0 -show_entries stream=width,height:stream_tags=rotate -of csv=p=0 input.mp4
</code>

returns:

<code bash>
1920,1080,270
</code>

<WRAP info>
**NOTE:**  Even though the rotation here is 270, the width and height are still shown as if the orientation was portrait.

  * Due to the 270 rotation, in reality the actual input should be 1080x1920, and not 1920x1080.
    * But ffprobe reports the actual width x height; Width is displayed first, then height (no matter the order it is requested).

</WRAP>


----

===== Using Grep =====

<code bash>
ffprobe somevideo.mp4 2>&1 | grep rotate
</code>

returns:

<code>
rotate          : 90
</code>

----

===== In a Bash Script =====

<code bash>
rotate=$(ffprobe -v error -select_streams v:0 -show_entries stream_tags=rotate -of csv=s=x:p=0 "${sourceFile}")
if [ "$rotate" != "" ]; then 
    echo "We need to rotate: $rotate"
fi
</code>

----