OMPlex is a Plex-based interface to OMXPlayer on the RaspberryPi. Using a Plex device, such as a smartphone or tablet, one can connect to OMPlex and playback videos on their RaspberryPi.
OMPlex is still quite rough around the edges, but it is useable, with the following exceptions:
- Experimental transcoder support
- Very basic channel support and only for supported media types
- No support for the web-based remote at plex.tv/web
- Only videos are supported (no picture or music support)
See the TODO for more information.
A simple OSD built ontop of OpenVG is also included. The ultimate goal is to be able to use it to switch subtitles and audio streams. For now it simply displays basic inforation about the currenly playing video. It mimicks the look and feel of Plex Home Theater's OSD, with some minor differences. Below is an example of what the OSD looks like:
Much of this work is based off of the (now defunct) PyPlex project, with the main difference being that OMPlex uses the (undocumented) "Timelines API". Support for this API was basically reverse engineered from Plex HT and Plex for Roku sources as well as some Wireshark snooping. The other main piece comes from the PlexGDM project.
OMPlex is written mainly in Python, so you will need a relatively recent 2.x version--2.6 or 2.7 should work just fine. The OSD is written in C, so you'll need gcc in order to compile it.
To install OMPlex just do the usual:
python setup.py install
The following Python libraries are also required and will be installed for you automatically if you use the setup script:
You'll also need OMXPlayer. You can find new builds for Debian-based distros here.
If you have a Raspbian-based distro, you should have an /opt/vc/lib directory, if you don't then the OSD will not build correctly.
Once you've installed OMPlex you can launch it::
omplex
You'll be prompted for you MyPlex username and password. You should now see "omplex" as a player from your Plex remote.
Currently the omplex command takes no arguments but this will change in the near future. For the time being I suggest you start a new screen and run omplex from in there. You will see a log of logging information printed to the screen. If you encounter errors, these messages can be helpful to try to debug.
If you use the setup script mentioned above and you have the required libaries then the OSD should build and install just fine. If there are errors, you can try to build the OSD manually by going into the osd directory and typing
make.
The first time you launch OMPLex it'll ask for your MyPlex credentials. This will change in the near future and all configuration will be done via a web browser. Currently, you can access the configuration page, once you've started OMPLex at http://127.0.0.1:3000/. Replace the IP address with your Pi's actual IP address. You should get a page like this:
OMPlex will do its best to use the streams that you've selected on your player. In the future the OSD will contain buttons to allow you to toggle the streams while the video is playing, but for now you must select the streams you want before you hit play on your remote.
- PyPlex - This doesn't work with the new Plex app on iOS, at least for me. It also seems to be dead.
- RasPlex - Some of the devs from PyPlex seem to have jumped ship and are now trying to get Plex HT to run on the RaspberryPi.
RasPlex is really the ideal solution--a full HTPC interface for Plex, awesome. In reality though, I have my doubts that Plex HT will ever run satisfactorily on the Pi. OMPlex player is designed to be lightweight and simple. Browse your Plex catalog on your phone and playback videos through the RaspberryPi.