Revision as of 13:35, 2 March 2013 by Ralph (talk | contribs)
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.

RaspberryPI 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 a mp4 file to watch it with omxplayer. If you have the URL of a (h264) rtmp:// stream, just stream it with:

omxplayer rtmp://...

To stream a (h264) rtmpt://... URL with omxplayer just change rtmpt:// to rtmp://


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 raspian 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 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 playthrough the HDMI cable:

omxplayer -o hdmi videofile.mp4

Helpful Links