Video on The Raspberry Pi


Omxplayer works with the VideoCore IV technology on the Raspberry Pi to produce video at 1080p60 or less at varying color depths.

Usage and Help

Usage: omxplayer [OPTIONS] [FILE]
-h  --help              Print this help
-v  --version           Print version info

Perhaps the most imporant, --help provides information and examples of how to use omxplayer.

Key Bindings

-k  --keys              Print key binding
    z           show info
    j           previous audio stream
    k           next audio stream
    i           previous chapter
    o           next chapter
    n           previous subtitle stream
    m           next subtitle stream
    s           toggle subtitles
    w           show subtitles
    x           hide subtitles
    d           decrease subtitle delay (- 250 ms)
    f           increase subtitle delay (+ 250 ms)
    q           exit omxplayer
    p / space   pause/resume
    -           decrease volume
    + / =       increase volume
    left arrow  seek -30 seconds
    right arrow seek +30 seconds
    down arrow  seek -600 seconds
    up arrow    seek +600 seconds
    1           decrease speed
    2           increase speed
    <           rewind
    >           fast forward

Accessing Stream Information

-i  --info                  Dump stream format and exit
-I  --with-info             dump stream format before playback

Audio Options

-n  --aidx  index           Audio stream index    : e.g. 1
-o  --adev  device          Audio out device      : e.g. hdmi/local/both/alsa[:device]
-p  --passthrough           Audio passthrough
-w  --hw                    Hw audio decoding
    --no-boost-on-downmix   Don't boost volume when downmixing
    --vol n                 set initial volume in millibels (default 0)
    --amp n                 set initial amplification in millibels (default 0)

Video Options

-y  --hdmiclocksync         Display refresh rate to match video (default)
-z  --nohdmiclocksync       Do not adjust display refresh rate to match video
-r  --refresh               Adjust framerate/resolution to video
    --no-osd                Do not display status information on screen

Additional Options

-s  --stats                 Pts and buffer stats
-d  --deinterlace           Force deinterlacing
    --nodeinterlace         Force no deinterlacing
    --nativedeinterlace     let display handle interlace
    --anaglyph type         convert 3d to anaglyph
    --advanced[=0]          Enable/disable advanced deinterlace for HD videos (default enabled)
-3  --3d mode               Switch tv into 3d mode (e.g. SBS/TB)
-M  --allow-mvc             Allow decoding of both views of MVC stereo stream
-t  --sid index             Show subtitle with index
-g  --genlog                Generate log file
-l  --pos n                 Start position (hh:mm:ss)
-b  --blank[=0xAARRGGBB]    Set the video background color to black (or optional ARGB value)
    --loop                  Loop file. Ignored if file not seekable
    --no-keys               Disable keyboard input (prevents hangs for certain TTYs)
    --subtitles path        External subtitles in UTF-8 srt format
    --font path             Default: /usr/share/fonts/truetype/freefont/FreeSans.ttf
    --italic-font path      Default: /usr/share/fonts/truetype/freefont/FreeSansOblique.ttf
    --font-size size        Font size in 1/1000 screen height (default: 55)
    --align left/center     Subtitle alignment (default: left)
    --no-ghost-box          No semitransparent boxes behind subtitles
    --lines n               Number of lines in the subtitle buffer (default: 3)
    --win 'x1 y1 x2 y2'     Set position of video window
    --win x1,y1,x2,y2       Set position of video window
    --crop 'x1 y1 x2 y2'    Set crop area for input video
    --crop x1,y1,x2,y2      Set crop area for input video
    --aspect-mode type      Letterbox, fill, stretch. Default: stretch if win is specified, letterbox otherwise
    --audio_fifo  n         Size of audio output fifo in seconds
    --video_fifo  n         Size of video output fifo in MB
    --audio_queue n         Size of audio input queue in MB
    --video_queue n         Size of video input queue in MB
    --threshold   n         Amount of buffered data required to finish buffering [s]
    --timeout     n         Timeout for stalled file/network operations (default 10s)
    --orientation n         Set orientation of video (0, 90, 180 or 270)
    --fps n                 Set fps of video where timestamps are not present
    --live                  Set for live tv or vod type stream
    --layout                Set output speaker layout (e.g. 5.1)
    --dbus_name name        default: org.mpris.MediaPlayer2.omxplayer
    --key-config            Uses key bindings in  instead of the default
    --alpha                 Set video transparency (0..255)
    --layer n               Set video render layer number (higher numbers are on top)
    --display n             Set display to output to
    --cookie 'cookie'       Send specified cookie as part of HTTP requests
    --user-agent 'ua'       Send specified User-Agent as part of HTTP requests
    --lavfdopts 'opts'      Options passed to libavformat, e.g. 'probesize:250000,...'
    --avdict 'opts'         Options passed to demuxer, e.g., 'rtsp_transport:tcp,...'

For example:
./omxplayer -p -o hdmi test.mkv

Leave a Reply

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