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 all 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) , scroll to "Environment" and add the variable `XDG_SESSION_TYPE=x11`.
- 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