Skip to content

Conversation

@justbispo
Copy link

@justbispo justbispo commented Nov 9, 2025

Replaced the instructions to run Vesktop as a Wayland application for instructions to run Vesktop in XWayland mode.

Since Electron 38, it now "defaults to running as a native Wayland app when launched in a Wayland session". Users that might have a problem with this changed might want to force Vesktop to run in XWayland mode.

Closes #6


- If you are using Flatpak, open [Flatseal](https://flathub.org/en/apps/com.github.tchx84.Flatseal) and deny the `X11 windowing system` permission for Vesktop.
- If you are not using Flatpak, you can opt into Wayland by running vesktop with the `--ozone-platform-hint=auto` flag. To make this permanent, see [Making Command line flags permanent](#making-command-line-flags-permanent).
- If you are using Flatpak, open [Flatseal](https://flathub.org/en/apps/com.github.tchx84.Flatseal) and deny the `Wayland windowing system` permission for Vesktop.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't actually know if this will just work, can you verify?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't test it with Vesktop, but I tested with another program. Disabling that option made it start with XWayland.

@justbispo
Copy link
Author

I thought the permissions would work the same like other Flatpak apps I've tried, but after testing a few Electron apps, it seems Electron is a finicky about what mode to use.
ELECTRON_OZONE_PLATFORM_HINT was removed so I tested with XDG_SESSION_TYPE=x11 and it works now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Tips & Tricks page

2 participants