Revision as of 05:15, 6 August 2015 by Phgachoud (talk | contribs) (spellcheck correction)
Jump to: navigation, search

Omxplayer is a video player specifically made for the Raspberry Pi's GPU made by Edgar (gimli) Hucek from the XBMC project.

Raspberry Pi forum user spenning made precompiled binaries available on the forum. See here.


z           Show Info
1           Increase Speed
2           Decrease Speed
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
d           Subtitle delay -250 ms
f           Subtitle delay +250 ms
q           Exit OMXPlayer
Space or p  Pause/Resume
-           Decrease Volume
+           Increase Volume
Left Arrow  Seek -30
Right Arrow Seek +30
Down Arrow  Seek -600
Up Arrow    Seek +600



You do not need to download an MP4 file to watch it with Omxplayer. If you have the URL of a (H.264) rtmp:// stream, just stream it with:

omxplayer rtmp://...

To stream a (H.264) rtmpt://... URL with Omxplayer, just change the head rtmp:// to rtmpt://.


Support for RTSP was added in 2012[1] (for instance, allowing the use of VLC media player as the streaming server).


omxplayer -o local rtsp://


Black screen after playback

If you get a black screen on your X11 desktop after Omxplayer is finished, you can use this command to restore your view:

xrefresh -display :0

Or you can use a small Bash script for video playback to do this every time:

omxplayer "$@"
xrefresh -display :0

On Raspbian, xrefresh is part of the x11-xserver-utils package (apt-get install x11-xserver-utils).

No rights to VCHIQ

On bare installations of the default distributions, Omxplayer often has insufficient permissions to access /dev/vchiq. One solution would be to run Omxplayer as root, but a nicer solution is to add a udev rule so that /dev/vchiq is also accessible from other users. To accomplish this, do the following under root:

# echo 'SUBSYSTEM=="vchiq",GROUP="video",MODE="0660"' > /etc/udev/rules.d/10-vchiq-permissions.rules

Now add yourself to the group named 'video':

# usermod -aGvideo USERNAME

Reboot the Raspberry Pi, and you should be able to run Omxplayer without the vchiq-error showing up.


When using HDMI make sure to pass '-o hdmi' to Omxplayer if you want the audio to play through the HDMI cable:

omxplayer -o hdmi videofile.mp4

Helpful Links