Troubleshooting Poor Video Performance on Linux Laptops with Hybrid Graphics and Wayland -

Introduction to Troubleshooting

When dealing with Linux laptops that have hybrid graphics, getting the best video performance can be tough, especially with Wayland. I’ve seen this go wrong when people don’t take the time to understand how their system is set up. As of 2026, many Linux distributions have made big strides in supporting hybrid graphics and Wayland, but issues still pop up. In this article, we’ll go over some practical steps for troubleshooting poor video performance on these laptops.

Understanding Hybrid Graphics and Wayland

Hybrid graphics systems combine an integrated GPU (iGPU) with a dedicated GPU (dGPU), which is useful for saving power and boosting performance. Wayland, on the other hand, is a display server protocol designed to replace the X Window System. Its architecture is more secure and efficient, but it can also introduce new challenges when dealing with hybrid graphics. To figure out which GPU is currently in use, you can use the glxinfo command:

glxinfo | grep "OpenGL renderer"

This will show you which GPU is rendering OpenGL content. Don’t bother with the other glxinfo output - we just need this one line.

Identifying Performance Issues

Before diving into troubleshooting, it’s essential to identify the symptoms of poor video performance. These can include lag or stuttering when playing videos or games, high CPU usage when using graphics-intensive applications, inability to switch between GPUs, or crashes and freezes when using certain applications. I usually start with top or htop to get an idea of what’s going on:

sudo apt-get install htop
htop

This will give you a detailed overview of system resource usage. In practice, this is where people usually get burned - they don’t monitor their system resources closely enough.

Configuring Hybrid Graphics

To configure hybrid graphics on your Linux laptop, you’ll need to install the necessary drivers and configure the system to use the correct GPU. The real trick is to find the right drivers for your hardware. Here are some general guidelines:

Install the NVIDIA driver (if applicable):

sudo apt-get install nvidia-driver

Install the prime-select package (if available):

sudo apt-get install prime-select

Configure the system to use the dGPU or iGPU:

sudo prime-select nvidia

sudo prime-select intel

Note that the exact commands may vary depending on your distribution and hardware.

Wayland Configuration

Wayland configuration can also impact video performance. To configure Wayland, you’ll need to edit the ~/.config/wayland.ini file:

nano ~/.config/wayland.ini

Add the following lines to enable the dGPU:

[device]
gpu=/dev/dri/card1

Replace /dev/dri/card1 with the actual path to your dGPU. This is where people usually get lost - the wayland.ini file isn’t always straightforward.

Troubleshooting Steps

If you’re experiencing poor video performance, here are some troubleshooting steps to try:

Update drivers: Ensure that your graphics drivers are up-to-date. You can check for updates using your distribution’s package manager.
Disable compositor: Try disabling the compositor to see if it improves performance. You can do this by adding the following line to your ~/.config/wayland.ini file:

[core]
compositor=false

Switch to X11: If you’re experiencing issues with Wayland, try switching to X11 to see if it resolves the problem. You can do this by editing your ~/.xinitrc file:

nano ~/.xinitrc

Add the following line to start X11:

exec startx

Monitor system resources: Use tools like top or htop to monitor system resource usage and identify potential bottlenecks.

Additional Resources

For more information on configuring hybrid graphics and Wayland, you can refer to the following resources:

kernel.org for information on Linux kernel development and documentation
freedesktop.org for information on Wayland and other desktop-related projects

Final Thoughts

Troubleshooting poor video performance on Linux laptops with hybrid graphics and Wayland requires patience and persistence. By following these steps and monitoring your system resources, you should be able to identify and resolve common issues. If you’re still having trouble, it’s time to dig deeper and seek out more specific solutions.