Skip to content

Update Vesktop instructions for Wayland #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Update Vesktop instructions for Wayland #7

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1b415e3
Update Vesktop instructions for Wayland
justbispo Nov 9, 2025
73f61a6
Replace 'environments' with 'sessions'
justbispo Nov 9, 2025
c8aaf5d
Fix Flatseal instructions for Vesktop
justbispo Nov 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions src/content/docs/wiki/linux/tips.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ sidebar:
order: 1
---

## Wayland Support
## Run in XWayland mode

Vesktop runs as an X11 application by default. You can override this behaviour.
Vesktop runs as a Wayland application by default on Wayland sessions. You can override this behaviour.

- 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

@Vendicated Vendicated Nov 9, 2025

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

@justbispo justbispo Nov 9, 2025

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.

- If you are not using Flatpak, you can opt into X11 by running vesktop with the `--ozone-platform=x11` flag. To make this permanent, see [Making Command line flags permanent](#making-command-line-flags-permanent).

## GNOME Tray Icon

Expand All @@ -29,7 +29,7 @@ It should usually be in `/usr/share/applications/vesktop.desktop`.
Open it with a text editor and add your flags to the `Exec` line, after the binary path and before the `%U` (if it exists).

```
Exec=/usr/bin/vesktop --ozone-platform-hint=auto %U
Exec=/usr/bin/vesktop --ozone-platform=x11 %U
```

## Enable Middle Click Auto Scroll
Expand Down