TBOPlayer – GUI for OMXPlayer


Great tool to open multimedia files from a GUI:

Get it HERE https://github.com/KenT2/tboplayer

How to setup tboplayer

First install dependency pexpect:

wget http://pexpect.sourceforge.net/pexpect-2.3.tar.gz
tar xzf pexpect-2.3.tar.gz
cd pexpect-2.3
sudo python ./setup.py install
cd ..

Now install Player tboplayer:

wget https://github.com/KenT2/tboplayer/zipball/master/KenT2-tboplayer-522a7d6.zip
unzip KenT2-tboplayer-522a7d6.zip
mv KenT2-tboplayer-522a7d6 tboplayer
cd tboplayer
sudo chmod +x /home/pi/tboplayer/tboplayer.py
ls -n

To Run the app:


Placing an icon on the desktop

cd /home/pi/Desktop
touch tboplayer.desktop
sudo nano tboplayer.desktop

Paste in the following:

[Desktop Entry]
Comment=Media Player
Path= /home/pi/tboplayer
Exec=python /home/pi/tboplayer/tboplayer.py

CTRL+X, ‘Y’, then hit <Enter>


Read Me Contents:

A GUI interface using jbaiter’s pyomxplayer wrapper to control omxplayer


Instructions for installation on the official Debian Wheezy Raspbian image

  • requires the latest bug fixed version of omxplayer which you can get by doing apt-get update then apt-get upgrade
  • install pexpect by following the instructions at www.noah.org/wiki/pexpect
  • pyomxplayer is currently included inline in the code as I have made some modifications to jbaiter’s version, his original can be seen at https://github.com/jbaiter/pyomxplayer
  • download tboplayer.py into a directory
  • type python tboplayer.py from a terminal opened in the directory within which tboplayer.py is stored.
  • developed on raspbian wheezy with python 2.7



  • ADD – duplicates the Track>Add menu item
  • PLAY – Play the selected track
  • PAUSE – Pause playing, operational only during playing
  • STOP – Stop playing, operational only during playing
  • VOL +- – Volume control, operational only during playing


  • Track – add edit or remove a track from the current playlist
  • Playlist – save the current playlist or open a saved one
  • OMX – display the track information for the last played track (needs to be enabled in options)
  • Options -
    • Audio Output – play sound to hdmi or local output, auto does not send an audio option to omxplayer.
    • Mode – play the Single selected track, Repeat the single track or rotate around the Playlist starting from the selected track.
    • Initial directory for tracks – where Add Track starts looking.
    • Initial directory for playlists – where Open Playlist starts looking
    • Enable subtitles
    • OMX player options – add your own (no validation so be careful)
    • Debug – prints some debug text to the command line
    • Generate Track Information – parses the output of omxplayer, disabled by default as it may cause problems with some tracks.

A track is selected using a single click of the mouse, playing is started by pressing the Play button or the . key

During playing of a track a slightly modified set of omxplayer commands can be used from the keyboard but there must be FOCUS on TBOPlayer. A list of commands is provided in the help menu. Note: some of the commands are not implemented by omxplayer.

If you have problems playing a track try it from the command line with omxplayer -ohdmi file or omxplayer -olocal file