omxplayer
C++ C Shell Makefile
#538 Compare This branch is 375 commits ahead, 12 commits behind huceke:master.
Latest commit 62fb580 Jan 29, 2017 @eysispeisi eysispeisi committed with fix for issue #521
Neither Subtitles nor OSD text messages are shown in full screen.
Permalink
Failed to load latest commit information.
cores Initial import Mar 22, 2012
fonts Add support for italics in subtitles Jun 29, 2013
guilib Initial import Mar 22, 2012
linux Initial alsa support Aug 3, 2016
utils Do not create copy of CCriticalSection for each CSingleLock instance Nov 8, 2015
.gitignore add patch.flag status to .gitignore Jun 14, 2015
BitstreamConverter.cpp Switch from deprecated CODEC_ID to AV_CODEC_ID Feb 1, 2016
BitstreamConverter.h Remove unused header file DllAvFilter.h Oct 18, 2014
COPYING Initial import Mar 22, 2012
DllAvCodec.h Avoid using deprecated functions Feb 17, 2016
DllAvFormat.h Add new option "--lavfdopts" for passing key:value options to libavfo… Feb 17, 2016
DllAvUtil.h Add new option "--avdict" for passing key:value options to demuxer Mar 14, 2016
DllBCM.h Pick up some fixes from xbmc. Jan 23, 2013
DllOMX.h Update to latest xbmc OMXCore.cpp Oct 23, 2013
DllSwResample.h Fix sound with recent FFmpeg by converting from av_audio_convert API … Jan 23, 2013
DynamicDll.cpp Initial import Mar 22, 2012
DynamicDll.h Initial import Mar 22, 2012
File.cpp Allow reading from stdin with pipe:0 notation Jun 11, 2013
File.h Allow reading from stdin with pipe:0 notation Jun 11, 2013
KeyConfig.cpp Fix for key(board) input pause ('p'/space) didn't paused/resumed player. May 27, 2016
KeyConfig.h Improved DBus support according to MPRIS2 specifications (with mainta… May 27, 2016
Keyboard.cpp Include hex code of key pressed in log Jun 29, 2015
Keyboard.h Fix stdin control in absence of dbus Jul 20, 2014
Makefile Initial alsa support Aug 3, 2016
Makefile.ffmpeg ffmpeg: Bump to v3.1 Jun 26, 2016
Makefile.include makefile_hack Jul 16, 2013
OMXAudio.cpp Initial alsa support Aug 3, 2016
OMXAudio.h Initial alsa support Aug 3, 2016
OMXAudioCodecOMX.cpp OMXPlayer: Fix bug where audio timestamps fail to update Sep 22, 2016
OMXAudioCodecOMX.h Fix for channel count when using request_channel_layout with TrueHD Nov 25, 2014
OMXClock.cpp Remove warnings Jul 24, 2014
OMXClock.h [omxplayer] Use media for determing audio delay and cache time Mar 28, 2014
OMXControl.cpp Fix dbus message handling problems May 31, 2016
OMXControl.h Fix dbus message handling problems May 31, 2016
OMXCore.cpp Initial alsa support Aug 3, 2016
OMXCore.h omxcore: Use const more Jun 24, 2014
OMXOverlay.h Initial import Mar 22, 2012
OMXOverlayCodec.h Initial import Mar 22, 2012
OMXOverlayCodecText.cpp subs: Reduce field count from 9 to 8. Mar 23, 2016
OMXOverlayCodecText.h Initial import Mar 22, 2012
OMXOverlayText.h Initial import Mar 22, 2012
OMXPlayerAudio.cpp Remove unused WaitCompletion function May 10, 2016
OMXPlayerAudio.h Remove unused WaitCompletion function May 10, 2016
OMXPlayerSubtitles.cpp Subtitle scaling with video size (#519) Jan 24, 2017
OMXPlayerSubtitles.h Subtitle scaling with video size (#519) Jan 24, 2017
OMXPlayerVideo.cpp Add options to configure aspect mode and crop video. Oct 24, 2015
OMXPlayerVideo.h Avoid overflow when queue size is greater than 1GB Nov 21, 2015
OMXReader.cpp Fix bug where cookie and user-agent values aren't set when --live fla… Oct 10, 2016
OMXReader.h Add new option "--avdict" for passing key:value options to demuxer Mar 14, 2016
OMXStreamInfo.cpp Switch from deprecated CODEC_ID to AV_CODEC_ID Feb 1, 2016
OMXStreamInfo.h Fix aspect ratio issue by implementing same logic as kodi Dec 3, 2015
OMXSubtitleTagSami.cpp Add support for italics in subtitles Jun 29, 2013
OMXSubtitleTagSami.h Change to std::string in COMXSubtitleTagSami (from XBMC) Jun 13, 2012
OMXThread.cpp Fix order of operations on pthread attribute: init first, then modify Nov 8, 2015
OMXThread.h Initial import Mar 22, 2012
OMXVideo.cpp Reset EOS state on flush. May 9, 2016
OMXVideo.h deinterlace: Default to advanced (qpu) deinterlace by default Jun 26, 2016
RBP.h Initial import Mar 22, 2012
README.md Initial alsa support Aug 3, 2016
Srt.cpp Add on-screen display Jul 28, 2013
Srt.h external SRT subtitles; smaller, customizable, subtitle buffer size; … Jan 26, 2013
Subtitle.h external SRT subtitles; smaller, customizable, subtitle buffer size; … Jan 26, 2013
SubtitleRenderer.cpp Subtitle scaling with video size (#519) Jan 24, 2017
SubtitleRenderer.h Subtitle scaling with video size (#519) Jan 24, 2017
Unicode.cpp OpenVG subtitles Aug 1, 2012
Unicode.h OpenVG subtitles Aug 1, 2012
dbuscontrol.sh Improved DBus support according to MPRIS2 specifications (with mainta… May 27, 2016
gen_version.sh Converted gen_version.sh to bash script. Fixes popcornmix/omxplayer#26 Aug 14, 2013
omxplayer omxplayer: Use complete library path under ffmpeg_compiled for local … Feb 19, 2016
omxplayer.cpp fix for issue #521 Jan 29, 2017
prepare-native-raspbian.sh Add libasound2-dev as required package Sep 17, 2016
profiler.sh Initial import Mar 22, 2012
system.h remove irrelevant OpenGL includes Jul 25, 2013

README.md

omxplayer(1) -- Raspberry Pi command line OMX player

OMXPlayer is a commandline OMX player for the Raspberry Pi. It was developed as a testbed for the XBMC Raspberry PI implementation and is quite handy to use standalone.

DOWNLOADING

git clone https://github.com/popcornmix/omxplayer.git

HELP AND DOCS

omxplayer's built-in help and the man page are all generated from this README.md file during make. You may need to change the Makefile if you modify the structure of README.md!

COMPILING

Run this script which will install build dependency packages, including g++ 4.7, and update firmware

./prepare-native-raspbian.sh

Build with

make ffmpeg
make

Install with

sudo make install

CROSS COMPILING

You need the content of your sdcard somewhere mounted or copied. There might be development headers to install on the running Pi system for the crosscompiling.

Edit Makefile.include and change the settings according your locations.

make ffmpeg
make
make dist

Installing OMXPlayer

You may want to specify a valid font path inside the omxplayer shell script. Copy over omxplayer-dist/* to the Pi /.

SYNOPSIS

Usage: omxplayer [OPTIONS] [FILE]

-h  --help                  Print this help
-v  --version               Print version info
-k  --keys                  Print key bindings
-n  --aidx  index           Audio stream index    : e.g. 1
-o  --adev  device          Audio out device      : e.g. hdmi/local/both/alsa[:device]
-i  --info                  Dump stream format and exit
-I  --with-info             dump stream format before playback
-s  --stats                 Pts and buffer stats
-p  --passthrough           Audio passthrough
-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)
-w  --hw                    Hw audio decoding
-3  --3d mode               Switch tv into 3d mode (e.g. SBS/TB)
-M  --allow-mvc             Allow decoding of both views of MVC stereo stream
-y  --hdmiclocksync         Display refresh rate to match video (default)
-z  --nohdmiclocksync       Do not adjust display refresh rate to match video
-t  --sid index             Show subtitle with index
-r  --refresh               Adjust framerate/resolution to video
-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-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)
    --no-osd                Do not display status information on screen
    --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 <file>     Uses key bindings in <file> 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

KEY BINDINGS

Key bindings to control omxplayer while playing:

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

KEY CONFIG SYNTAX

A key config file is a series of rules of the form [action]:[key]. Multiple keys can be bound to the same action, and comments are supported by adding a # in front of the line. The list of valid [action]s roughly corresponds to the list of default key bindings above and are:

DECREASE_SPEED
INCREASE_SPEED
REWIND
FAST_FORWARD
SHOW_INFO
PREVIOUS_AUDIO
NEXT_AUDIO
PREVIOUS_CHAPTER
NEXT_CHAPTER
PREVIOUS_SUBTITLE
NEXT_SUBTITLE
TOGGLE_SUBTITLE
DECREASE_SUBTITLE_DELAY
INCREASE_SUBTITLE_DELAY
EXIT
PAUSE
DECREASE_VOLUME
INCREASE_VOLUME
SEEK_BACK_SMALL
SEEK_FORWARD_SMALL
SEEK_BACK_LARGE
SEEK_FORWARD_LARGE
STEP

Valid [key]s include all alpha-numeric characters and most symbols, as well as:

left
right
up
down
esc
hex [keycode]

For example:

EXIT:esc
PAUSE:p
#Note that this next line has a space after the :
PAUSE: 
REWIND:left
SEEK_FORWARD_SMALL:hex 0x4f43
EXIT:q

DBUS CONTROL

omxplayer can be controlled via DBUS. There are three interfaces, all of which present a different set of commands. For examples on working with DBUS take a look at the supplied dbuscontrol.sh file.

Root Interface

The root interface is accessible under the name org.mpris.MediaPlayer2.

Methods

Root interface methods can be accessed through org.mpris.MediaPlayer2.MethodName.

Quit

Stops the currently playing video. This will cause the currently running omxplayer process to terminate.

Params Type
Return null
Raise

No effect.

Params Type
Return null

Properties

Root interface properties can be accessed through org.freedesktop.DBus.Properties.Get and org.freedesktop.DBus.Properties.Set methods with the string "org.mpris.MediaPlayer2" as first argument and the string "PropertyName" as second argument.

CanQuit (ro)

Whether or not the player can quit.

Params Type
Return boolean
Fullscreen (ro)

Whether or not the player can is fullscreen.

Params Type
Return boolean
CanSetFullscreen (ro)

Whether or not the player can set fullscreen.

Params Type
Return boolean
CanRaise (ro)

Whether the display window can be brought to the top of all the window.

Params Type
Return boolean
HasTrackList (ro)

Whether or not the player has a track list.

Params Type
Return boolean
Identity (ro)

Name of the player.

Params Type
Return string
SupportedUriSchemes (ro)

Playable URI formats.

Params Type
Return string[]
SupportedMimeTypes (ro)

Supported mime types. Note: currently not implemented.

Params Type
Return string[]

Player Interface

The player interface is accessible under the name org.mpris.MediaPlayer2.Player.

Methods

Player interface methods can be accessed through org.mpris.MediaPlayer2.Player.MethodName.

Next

Skip to the next chapter.

Params Type
Return null
Previous

Skip to the previous chapter.

Params Type
Return null
Play

Play the video. If the video is playing, it has no effect, if it is paused it will play from current position and if it is stopped it will play from the beginning.

Params Type
Return null
Pause

Pause the video. If the video is playing, it will be paused, if it is paused it will stay in pause (no effect).

Params Type
Return null
PlayPause

Toggles the play state. If the video is playing, it will be paused, if it is paused it will start playing.

Params Type
Return null
Stop

Stops the video.

Params Type
Return null
Seek

Perform a relative seek, i.e. seek plus or minus a certain number of microseconds from the current position in the video.

Params Type Description
1 int64 Microseconds to seek
Return null or int64 If the supplied offset is invalid, null is returned, otherwise the offset (in microseconds) is returned
SetPosition

Seeks to a specific location in the file. This is an absolute seek.

Params Type Description
1 string Path (not currently used)
2 int64 Position to seek to, in microseconds
Return null or int64 If the supplied position is invalid, null is returned, otherwise the position (in microseconds) is returned
Mute

Mute the audio stream. If the volume is already muted, this does nothing.

Params Type
Return null
Unmute

Unmute the audio stream. If the stream is already unmuted, this does nothing.

Params Type
Return null
ListSubtitles

Returns a array of all known subtitles. The length of the array is the number of subtitles. Each item in the araay is a string in the following format:

<index>:<language>:<name>:<codec>:<active>

Any of the fields may be blank, except for index. language is the language code, such as eng, chi, swe, etc. name is a description of the subtitle, such as foreign parts or SDH. codec is the name of the codec used by the subtitle, sudh as subrip. active is either the string active or an empty string.

Params Type
Return string[]
ListAudio

Returns and array of all known audio streams. The length of the array is the number of streams. Each item in the array is a string in the following format:

<index>:<language>:<name>:<codec>:<active>

See ListSubtitles for a description of what each of these fields means. An example of a possible string is:

0:eng:DD 5.1:ac3:active
Params Type
Return string[]
ListVideo

Returns and array of all known video streams. The length of the array is the number of streams. Each item in the array is a string in the following format:

<index>:<language>:<name>:<codec>:<active>

See ListSubtitles for a description of what each of these fields means. An example of a possible string is:

0:eng:x264:h264:active
Params Type
Return string[]
SelectSubtitle

Selects the subtitle at a given index.

Params Type Description
1 int32 Index of subtitle to select
Return boolean Returns true if subtitle was selected, `false otherwise
SelectAudio

Selects the audio stream at a given index.

Params Type Description
1 int32 Index of audio stream to select
Return boolean Returns true if stream was selected, `false otherwise
ShowSubtitles

Turns on subtitles.

Params Type
Return null
HideSubtitles

Turns off subtitles.

Params Type
Return null
GetSource

The current file or stream that is being played.

Params Type
Return string
Action

Execute a "keyboard" command. For available codes, see KeyConfig.h.

Params Type Description
1 int32 Command to execute
Return null

Properties

Player interface properties can be accessed through org.freedesktop.DBus.Properties.Get and org.freedesktop.DBus.Properties.Set methods with the string "org.mpris.MediaPlayer2" as first argument and the string "PropertyName" as second argument.

CanGoNext (ro)

Whether or not the play can skip to the next track.

Params Type
Return boolean
CanGoPrevious (ro)

Whether or not the player can skip to the previous track.

Params Type
Return boolean
CanSeek (ro)

Whether or not the player can seek.

Params Type
Return boolean
CanControl (ro)

Whether or not the player can be controlled.

Params Type
Return boolean
CanPlay (ro)

Whether or not the player can play.

Return type: boolean.

CanPause (ro)

Whether or not the player can pause.

Params Type
Return boolean
PlaybackStatus (ro)

The current state of the player, either "Paused" or "Playing".

Params Type
Return string
Volume (rw)

When called with an argument it will set the volume and return the current volume. When called without an argument it will simply return the current volume. As defined by the MPRIS specifications, this value should be greater than or equal to 0. 1 is the normal volume. Everything below is quieter than normal, everything above is louder.

Millibels can be converted to/from acceptable values using the following:

volume = pow(10, mB / 2000.0);
mB     = 2000.0 * log10(volume)
Params Type Description
1 (optional) double Volume to set
Return double Current volume
Position (ro)

Returns the current position of the playing media.

Params Type Description
Return int64 Current position in microseconds
MinimumRate (ro)

Returns the minimum playback rate of the video.

Params Type
Return double
MaximumRate (ro)

Returns the maximum playback rate of the video.

Params Type
Return double
Rate (rw)

When called with an argument it will set the playing rate and return the current rate. When called without an argument it will simply return the current rate. Rate of 1.0 is the normal playing rate. A value of 2.0 corresponds to two times faster than normal rate, a value of 0.5 corresponds to two times slower than the normal rate.

Params Type Description
1 (optional) double Rate to set
Return double Current rate
Metadata (ro)

Returns track information: URI and length.

Params Type Description
Return dict Dictionnary entries with key:value pairs
Aspect (ro)

Returns the aspect ratio.

Params Type Description
Return double Aspect ratio
VideoStreamCount (ro)

Returns the number of video streams.

Params Type Description
Return int64 Number of video streams
ResWidth (ro)

Returns video width

Params Type Description
Return int64 Video width in px
ResHeight (ro)

Returns video width

Params Type Description
Return int64 Video height in px
Duration (ro)

Returns the total length of the playing media.

Params Type Description
Return int64 Total length in microseconds