Playing Videos On the Raspberry Pi Command Line

If Full HD Logoyou need to play video files and you don’t want to install a full media solution such as XBMC then you can play them directly from the command line using Omxplayer. This is a media player created by Edgar Hucek specifically for the Raspberry Pi and it takes advantage of the Pi’s GPU.

Installation

Omxplayer is installed on the latest Raspbian image so you may already have it installed. If not you can install it using :

sudo apt-get update
sudo apt-get -y install omxplayer

Basic Usage

To play a video file you just need to type :

omxplayer myvideo.mp4

If you are using HDMI you should use this command to pass audio over the HDMI interface :

omxplayer -o hdmi myvideo.mp4

HD Video With Omxplayer

Other Command Line Options

If you type :

omxplayer

you will be presented with a list of the available command line options :

Usage: omxplayer [OPTIONS] [FILE]
Options :
-h / --help                print this help
-n / --aidx  index         audio stream index    : e.g. 1
-o / --adev  device        audio out device      : e.g. hdmi/local
-i / --info                dump stream format and exit
-s / --stats               pts and buffer stats
-p / --passthrough         audio passthrough
-d / --deinterlace         deinterlacing
-w / --hw                  hw audio decoding
-3 / --3d mode             switch tv into 3d mode (e.g. SBS/TB)
-y / --hdmiclocksync       adjust display refresh rate to match
                           video (default)
-z / --nohdmiclocksync     do not adjust display refresh rate to
                           match video
-t / --sid index           show subtitle with index
-r / --refresh             adjust framerate/resolution to video
-l / --pos                 start position (in seconds)
    --boost-on-downmix     boost volume when downmixing
    --subtitles path       external subtitles in UTF-8 srt form at
    --font path            subtitle font
                           (default: /usr/share/fonts/truetype/
                                      freefont/FreeSans.ttf)
    --font-size size       font size as thousandths of screen height
                           (default: 55)
    --align left/center    subtitle alignment (default: left)
    --lines n              number of lines to accommodate in the
                           subtitle buffer (default: 3)

Keyboard Shortcuts

Here are the keyboard shortcuts that you can use to control features within the player :

Space or p   Pause/Resume
q            Exit OMXPlayer
z            Show Info

-            Decrease Volume
+            Increase Volume

i            Previous Chapter
o            Next Chapter

Left Arrow   Seek -30
Right Arrow  Seek +30
Down Arrow   Seek -600
Up Arrow     Seek +600

1            Increase Speed
2            Decrease Speed

j            Previous Audio stream
k            Next Audio stream
n            Previous Subtitle stream
m            Next Subtitle stream
s            Toggle subtitles
d            Subtitle delay -250 ms
f            Subtitle delay +250 ms

Omxplayer is particularly useful if you are creating videos with the Pi camera module and want to playback the files from the command line.

This entry was posted in Camera Module, Software, Tutorials & Help and tagged , , . Bookmark the permalink.


6 Responses to Playing Videos On the Raspberry Pi Command Line

  1. chris.tal says:

    It can even play streams and accepts some ffmpeg style URL options. Too bad the audio and video desyncs after a few hours for me. :/

  2. Sunil says:

    Hi All,
    I want to control the omxplayer using c script ,,
    How can i do this?
    please help me..

    Thanks and regards
    Sunil

  3. vijay says:

    Hi
    when i am using omx player myvideo.mp4.It is just showing blank screen and going
    any please help me.what is the problem with the omx player please help me.

  4. monkeypi says:

    im getting no sound even if i use omxplayer -o hdmi (file) any simple help much appreciated I’m noob

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>