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.

Disclaimer: Of course it should go without saying that it is not a good idea to run a code you find online on your computer without understanding it. So run the code presented here at your own risk. We try to vet all the code snippets on this website, but it is always possible that we miss something. To be clear, your computer and the code your decide to run on it is your responsibility.

🔗 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 definite 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

🔗 Reset Gnome shortcut permission

In Gome Wayland the users is asked if they want to give permission to the screenshot tool to capture the screen. It is possible to hit the wrong button and permanently block Flameshot from taking the screenshot. The workaround have been proposed by the community. Running the following command in terminal would reset the permission in Gnome Wayland:

dbus-send --session  --print-reply=literal --dest=org.freedesktop.impl.portal.PermissionStore /org/freedesktop/impl/portal/PermissionStore org.freedesktop.impl.portal.PermissionStore.D
eletePermission string:'screenshot' string:'screenshot' string:''

🔗 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.