QtPlex provides a Linux-first solution for streaming Plex media. The application is a shallow wrapper into the standard web interface, with the added benefits of native features such as media keyboard shortcuts.
- Accessible server running Plex.
- Install QtCreator. If you are an individual developer, you can use the free, open source installation.
- Install the libraries needed for QtPlex:
$ sudo apt-get install qtwebengine5-dev qtdeclarative5-dev libqt5x11extras5-dev libfontconfig1-dev libfreetype6-dev libx11-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libx11-xcb-dev libxcb-glx0-dev libxkbcommon-x11-dev
- Open the QtPlex.pro file in QtCreator, then build/run.
- [Optional] Add a desktop file for launching:
[Desktop Entry]
Type=Application
Name=QtPlex
Keywords=audio;plex;qt
Icon=/path/to/build-QtPlex-Desktop-Release/res/icon256.png
Exec=/path/to/build-QtPlex-Desktop-Release/QtPlex
Terminal=false
StartupWMClass=QtPlex
If you notice the application no longer responding to media keys, and instead a pop-up shown indicating there are no media applications present, you can disable GNOME from intercepting X keys. You can read more here.
Workaround:
- Install
dconf-editor - Open
dconf-editorand navigate toorg.gnome.settings-daemon.plugins.media-keys. - Remove the
previous-staticbinding by changing the value to nothing (['']). - Repeat the above for
pause-static,play-static,stop-staticandnext-static. - If problems persist, look through the settings in step two and validate nothing is bound to suspicious
XF86Audio*keys.
In order to enable full functionality of the Plex web app (video and particular audio), some proprietary codecs need to be available to the QtWebEngine. Unfortunately, due to licensing, these cannot be packaged with the Qt libraries, or through this application. As such, you'll need to build the QtWebEngine from source. You can find more information on building QtWebEngine from source here. Before running the qmake command in that guide, you'll need to enable the proprietary codecs using the --webengine-proprietary-codecs flag. For example, qmake -r -- --webengine-proprietary-codecs. More information on that can be found here.
This project is dependent on Plex and Qt, and the hard-working developers there who build and maintain the core features that QtPlex relies on. Additionally, QHotKey enabled the base framework for cross-platform keyboard hooks.