Omxplayer is a command line player which is part of XBMC. It is a video player specifically made for the Raspberry PI's GPU.


Omxplayer is included with the Rasbioan operating system, but if you need to install it you can use: 

sudo apt-get install omxplayer


Key Bindings:

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
q Exit
Space or p Pause/Resume
– Decrease Volume
+ Increase Volume
Left Seek -30
Right Seek +30
Down Seek -600
Up Seek +600

Playing A RTSP Stream From An Axis Camera

At the command line:

omxplayer rtsp://root:[email protected]/axis-media/media.amp?resolution=800x450

Video Formats

Omxplayer is picky about video content. The recommended encoding is H264 MPEG4 videos.   As long as you properly encode you videos it can handle 1080p videos beautifully.

Displaying Images

omxplayer does not currently have the capability to display still images and there are no current plans to add this (09/2013

Playing Audio Files

From the command line:

omxplayer /home/pi/projects/my_project/audio/my_audio.wav

Sending Audio To The HDMI Port

Apparently this works (we've not tried it yet ourselves)

omxplayer -p -o hdmi myaudio.mp4





We benefit hugely from resources on the web so we decided we should try and give back some of our knowledge and resources to the community by opening up many of our company’s internal notes and libraries through mini sites like this. We hope you find the site helpful.
Please feel free to comment if you can add help to this page or point out issues and solutions you have found, but please note that we do not provide support on this site. If you need help with a problem please use one of the many online forums.


  1. tmaster

    2 years ago

    Why does this no longer work in os 11.

    sudo apt-get install omxplayer
    Reading package lists… Done
    Building dependency tree… Done
    Reading state information… Done
    Package omxplayer is not available, but is referred to by another package.
    This may mean that the package is missing, has been obsoleted, or
    is only available from another source

    E: Package ‘omxplayer’ has no installation candidate

    1. jose

      2 years ago

      as per

      Note: omxplayer is being deprecated and resources are directed at improving vlc.

      This is due to: omxplayer uses openvg for OSD and subtitles which isn’t supported on Pi4. omxplayer uses openmax which has been deprecated for a long time and isn’t supported with 64-bit kernels. omxplayer does not support software decode omxplayer does not support advanced subtitles omxplayer does not support playback from ISO files. omxplayer does not integrate with the X desktop

  2. captain

    3 years ago

    I’m pretty sure that 1 is reduce speed, 2 his increase speed.
    Does anyone know why, sometime around Thanksgiving, omxplayer stopped displaying elapsed time and total time when paused?

  3. Hengst

    3 years ago

    would like to add that for m3u8 streams, you whant to add timeout option to 60s beacuse else stream will stop every 30seconds or so.

    so that would be : omxplayer http://whatever.m3u8 –live –timeout 60

    also you can use omxplayer “http://whatever.url?account=youraccount&whatever=option&file.m3u8” –live –timeout 60

    1. hengst

      3 years ago

      also i found you might remove –live in some cases to keep the stream playing smoohtly for longer time.

  4. Tom Kastner

    9 years ago

    I need to know how to play playlists of mp3 files!

    1. jappe

      8 years ago

      Write that in python :P

  5. Kyle

    9 years ago

    This thing sucks… There’s no way to pipe h.264 directly from Python, so you’re stuck with the severely limited features written into this pile of garbage.

    Where is the feature to call current clip time/position via STDIN/OUT? Where is the option to seek to a specific time code? Since Broadcom refuses to release the GPU specs, they sould at least release some tools that give you some real control over the damnable playback!


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