README.md

Intel GPU Monitor plasmoid

Plasma Widget that displays Intel GPU usage including wether or not video acceleration is being used

Screenshots

More

Settings

Tooltip

Requirements

• intel-gpu-tools package

• Giving intel_gpu_top the ability to use performance monitoring features using sudo setcap cap_perfmon=+ep /usr/bin/intel_gpu_top every reboot, or you can use the following Systemd Unit

1. Create /etc/systemd/system/setcap_intel_gpu_top.service with the following:

   [Unit]
   Description=Set intel_gpu_top perfmon capabilities
   After=graphical.target
   
   [Service]
   ExecStart=/sbin/setcap cap_perfmon=+ep /usr/bin/intel_gpu_top
   Type=oneshot
   RemainAfterExit=yes
   
   [Install]
   WantedBy=graphical.target

2. Start & enable the service

   sudo systemctl enable --now setcap_intel_gpu_top.service

3. In systems such as Ubuntu, performance events monitoring are disabled by default. For intel_gpu_top to work without root you need to set /proc/sys/kernel/perf_event_paranoid to 2. Otherwise you may get an error like this:

    $ intel_gpu_top
    Failed to initialize PMU! (Permission denied)
    ...

   To solve this, lower the paranoid level to 2 by running sudo sysctl kernel.perf_event_paranoid=2

   • To make it permanent create the file /etc/sysctl.d/99-sysctl-paranoid.conf with the following content

     kernel.perf_event_paranoid = 2

   Finally, run intel_gpu_top to verify it works

Current & planned features

• Show General usage
  • Load, Frequency, Power consumption
  • Usage per engine (Render/3D, Video & VideoEnhance, Blitter)
• Show top clients (program names) per engine
  • Custom max clients (program names) to show in engine utilization
• GPU selection
• Custom icons support
• Show current engine load
  • With badge
  • With color dot
• Custom engine utilization threshold to update icons
• Show intel_gpu_top isn't available or doesn't have perfmon capabilities set

Installing

• Install from KDE Store or use Get new widgets..
  • Plasma 5 version
  • Plasma 6 version

Manual install

Important

The main branch was updated to support Plasma 6, to install from source in plasma 5 run git checkout kf5 before the install script.

1. Install these dependencies (please let me know if I missed or added something unnecessary)

   cmake extra-cmake-modules libplasma intel-gpu-tools

2. Run ./install.sh

Resources

• IGT GPU Tools
• Perf events and tool security — The Linux Kernel documentation
• capabilities(7) - overview of Linux capabilities — Linux manual page
• setcap(8) - set file capabilities — Linux manual page
• No API/user accessible sysfs files to get GPU stats - drm/intel/issues

Credits

• Google LLC. / Pictogrammers for the panel icons