README.md

eglfs

Qt platform plugin with DRM/KMS support. It's a fork of Qt's eglfs plugin with more feature such as:

• Get permission to access devices to unprivileged users using logind.
• Screen configuration.
• Real-time screen recording.

This plugin extends Qt hence you have to rebuild it every time Qt is updated.

Dependencies

Qt >= 5.9.0 with at least the following modules is required:

• qtbase

And the following modules:

• cmake >= 3.10.0
• cmake-shared >= 1.0.0
• libliri
• qtudev >= 1.0.0
• libinput >= 0.12
• libdrm
• gbm
• egl

Installation

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
make
make install # use sudo if necessary

Replace /path/to/prefix to your installation prefix. Default is /usr/local.

You can also append the following options to the cmake command:

• -DEGLFS_DRM_ATOMIC:BOOL=OFF: Disable DRM atomic support.

Environment variables

The liri QPA plugin supports different graphics hardware through EGL device integration plugins.

The environment variables that can influence the QPA plugin are the same as those of eglfs.

Logging categories

Qt 5.2 introduced logging categories and Liri takes advantage of them to make debugging easier.

Please refer to the Qt documentation to learn how to enable them.

Available categories

• Platform:

  • liri.qpa.deviceintegration: Device integration
  • liri.qpa.input: Input management on device integration plugins

• EGL Device Integrations:

  • liri.qpa.kms: KMS/DRM EGL device integration
  • liri.qpa.vthandler: Vt handler

Licensing

Licensed under the terms of the GNU General Public License version 3.