Difference between revisions of "Omxplayer"

From eLinux.org
Jump to: navigation, search
(Hotkeys)
Line 5: Line 5:
 
Raspberry Pi forum user ''spenning'' made precompiled binaries available on the forum. See [http://www.raspberrypi.org/phpBB3/viewtopic.php?f=2&t=5543 here].
 
Raspberry Pi forum user ''spenning'' made precompiled binaries available on the forum. See [http://www.raspberrypi.org/phpBB3/viewtopic.php?f=2&t=5543 here].
  
== Hotkeys ==
+
== KEY BINDINGS ==
 
<pre>
 
<pre>
z           Show Info
+
1          decrease speed
1           Increase Speed
+
2          increase speed
2           Decrease Speed
+
<           rewind
j          Previous Audio stream
+
>           fast forward
k          Next Audio stream
+
z           show info
i          Previous Chapter
+
j          previous audio stream
o          Next Chapter
+
k          next audio stream
n          Previous Subtitle stream
+
i          previous chapter
m          Next Subtitle stream
+
o          next chapter
s          Toggle subtitles
+
n          previous subtitle stream
d          Subtitle delay -250 ms
+
m          next subtitle stream
f          Subtitle delay +250 ms
+
s          toggle subtitles
q          Exit OMXPlayer
+
w          show subtitles
Space or p Pause/Resume
+
x          hide subtitles
-          Decrease Volume
+
d          decrease subtitle delay (- 250 ms)
+           Increase Volume
+
f          increase subtitle delay (+ 250 ms)
Left Arrow Seek -30
+
q          exit omxplayer
Right Arrow Seek +30
+
p / space  pause/resume
Down Arrow Seek -600
+
-          decrease volume
Up Arrow   Seek +600
+
+ / =      increase volume
 +
left arrow seek -30 seconds
 +
right arrow seek +30 seconds
 +
down arrow seek -600 seconds
 +
up arrow   seek +600 seconds
 
</pre>
 
</pre>
  

Revision as of 10:12, 18 February 2016


Omxplayer is a video player specifically made for the Raspberry Pi's GPU made by Edgar (gimli) Hucek from the XBMC/Kodi project. It relies on the OpenMAX hardware acceleration API, which is the Broadcom's VideoCore officially supported API for GPU video/audio processing.

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

KEY BINDINGS

1           decrease speed
2           increase speed
<           rewind
>           fast forward
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

Streaming

RTMP

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://.

RTSP

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

Example:

omxplayer -o local rtsp://192.168.3.100:8554/stream1

Audio

It is possible to select the audio output by specifying -o or --adev on the command line between:

  • local: analog output
  • hdmi: hdmi output (hdmi_drive=2 is then required in config.txt)
  • both: both outputs

Example:

omxplayer -o hdmi file.qt

Troubleshooting

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:

#/bin/bash
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.

HDMI

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

References