Skip to content
BlueMail Help BlueMail Help

Resolving Display Issues on Linux with Wayland and Fractional Scaling

Desktop

Issue Summary - Linux only

Some users may experience display issues with BlueMail on Linux distributions that use Wayland, especially when Fractional Scaling is enabled. These issues can include improper application scaling, blurry fonts, or interface elements not aligning correctly.

Cause

Wayland is a modern replacement for the X11 display server, offering improved security and performance. However, not all applications are fully optimized for Wayland's handling of scaling, especially when Fractional Scaling is used to adjust the DPI settings for high-resolution displays.

Fractional Scaling allows for a more fine-grained scaling of the UI, which is beneficial for high-resolution displays. However, it can lead to issues in applications that are not fully compatible with Wayland's scaling methods.

Solution

Running BlueMail with specific flags can force it to better handle Wayland's display protocol and Fractional Scaling. The flags --enable-features=UseOzonePlatform and --ozone-platform=wayland are used to improve compatibility and performance on Wayland.

Steps to Apply the Workaround

  1. Close BlueMail: Ensure the application is fully closed.

  2. Open Terminal: Access the command-line interface of your system.

  3. Launch BlueMail with the flags: Execute the following command in the terminal:

    /opt/BlueMail/bluemail --enable-features=UseOzonePlatform --ozone-platform=wayland

  4. Verify: Open BlueMail to check if the display issues have been resolved.

Explanation of Flags

  • --enable-features=UseOzonePlatform: This flag enables the use of the Ozone platform abstraction layer in Chromium. Ozone improves compatibility with different window systems and display protocols, like Wayland.
  • --ozone-platform=wayland: This flag explicitly sets Wayland as the backend for Ozone. It ensures BlueMail use Wayland for display management, which can resolve issues related to Fractional Scaling and overall display rendering.

Additional Information

These flags are particularly useful if you are running BlueMail on a Linux system with Wayland and have Fractional Scaling enabled. They force BlueMail to better adhere to Wayland's protocols, potentially resolving a range of display-related issues.

Support

If the issue persists or you encounter other problems, reach out to our support team with the details of your issue for further assistance.