Skip to content

Instantly share code, notes, and snippets.

Last active Mar 18, 2022
What would you like to do?
Visual Studio Code: Enable native Wayland support

Native wayland support is now working consistently for me in VSCode, giving much better text rendering. Unfortunately, it's still hidden behind some command-line flags.

By adding some files to /usr/local/*, you can ensure that VSCode always launches with these flags.

Adding launch flags to VSCode

Assuming that the VSCode launcher is /usr/bin/code-oss (as is the case in Arch):

  1. Create /usr/local/bin/code-oss with the following content:
exec /usr/bin/code-oss --enable-features=UseOzonePlatform --ozone-platform=wayland "$@"
  1. chmod a+x /usr/local/bin/code-oss
  2. In /usr/local/share/applications/, create modified versions of any vscode entries in /usr/share/applications/*.desktop, which is where many launchers get their application info. Add the new flags to the Exec= lines, e.g. for Arch:
sudo mkdir -p /usr/local/share/applications/
for f in code-oss code-oss-url-handler; do
    sed -E 's:^(Exec=[^ ]+)(.*)$:\1 --enable-features=UseOzonePlatform --ozone-platform=wayland\2:' < /usr/share/applications/$f.desktop | sudo tee /usr/local/share/applications/$f.desktop
  1. If your distro provides simlinks to the "real" vscode launcher, like code to launch code-oss, override those too:
ln -s /usr/local/bin/code-oss /usr/local/bin/code


  • restart your application launcher
    • for Gnome: update-desktop-database /usr/local/share/applications
  • ensure that your $PATH includes /usr/local/bin somewhere before /usr/bin
  • check that /usr/local/bin/code-oss is executable
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment