Wayland Help

Troubleshooting Flameshot on Wayland

In this page you can find possible solutions for issues on Wayland. This page probably needs frequent update, so if something was outdate, please report it here.

🔗 Gnome Wayland

🔗 I am asked to "Share" my screen every time

gnome permission window

If you are a Gnome 41 (or later) user, know that you are not alone in this as many have brought up this issue (example). This is NOT a Flameshot bug nor it was our decision. This is something that Gnome developers unilaterally and suddenly implemented and this is affecting ALL screenshot tools other than the Gnome default screenshot tool (they have white-listed their own software). For more information please read the following:

Therefore please do not waste your time (like many have) by complaining to Flameshot developers. We cannot do anything about it! If you want this issue to change, please take your complaints to here and here.

Thank you!

🔗 Can't screen anything on Wayland Gnome

Symptom: Launcher (right-click on tray icon, then "Open Launcher") does not show anything in the preview section (left-side of the window)

You install xdg-desktop-portal-gnome and xdg-desktop-portal.

🔗 Gnome shortcut does not trigger Flameshot

Symptom: When using a shortcut (Print screen) to run Flameshot I get "Unable to capture screen". When I run the command from the shortcut in a terminal, it works. Both used to work fine before, but stopped working after my daily updates. The normal Gnome screenshot program still works. [source]

We don't have a definit answer of what in Gnome have changed, but Gnome users have provided the following solution:

Run the flameshot gui via a shell script

script --command "QT_QPA_PLATFORM=wayland flameshot gui" /dev/null
# or
bash -c -- "QT_QPA_PLATFORM=wayland flameshot gui"
# or
sh -c -- "QT_QPA_PLATFORM=wayland flameshot gui"

If this didn't solve your issue or if you are not sure what you do about this, Best places to look for are #3365 and #3326.

In general, these specific comments worth your attention:

  • https://github.com/flameshot-org/flameshot/issues/3326#issuecomment-1789267986
  • https://github.com/flameshot-org/flameshot/issues/3326#issuecomment-1826336292
  • https://github.com/flameshot-org/flameshot/issues/3365#issuecomment-1928940359
  • https://github.com/flameshot-org/flameshot/issues/3365#issuecomment-1930538662
  • https://github.com/flameshot-org/flameshot/issues/3365#issuecomment-1817581463
  • https://github.com/flameshot-org/flameshot/issues/3365#issuecomment-1810832381
  • Specifically for NixOS users

🔗 KDE Wayland

🔗 4k displayed and fractional scaling

It has been reported that setting the environmental variable QT_SCREEN_SCALE_FACTORS to 1;1 can solve the issue. You can do the following every time your computer boots:

export QT_SCREEN_SCALE_FACTORS="1;1"

and then you can normally use Flameshot (e.g flameshot gui)

🔗 Can't screen anything on Wayland KDE

Symptom: Launcher (right-click on tray icon, then "Open Launcher") does not show anything in the preview section (left-side of the window)

You install xdg-desktop-portal-kde and xdg-desktop-portal.