Flameshot: Difference between revisions

Line 88:

};

};|name=/etc/nixos/home.nix|lang=nix}}

== Troubleshooting ==

With the release of v14.0.0 of Flameshot, users may experience several issues depending on their setup. This section will cover most common situations and their solutions.

=== Unable to take a screenshot: portal timed out/screenshot aborted ===

By default, Flameshot now uses XDG desktop portal calls for screenshotting. This necessitates having <code>xdg-desktop-portal</code> + portal(s) with Access and Screenshot interfaces installed (see ArchWiki's [https://wiki.archlinux.org/title/XDG_Desktop_Portal#List_of_backends_and_interfaces Portal Backends] list). Without those, screenshot attempts will fail.

Users on X11 window managers will be unable to use the default method; no portal provides a Screenshot interface there. The solution is to enable "Use legacy X11 screenshot" method located in the "General" tab of Flameshot GUI config. If using Home Manager's Flameshot module, this option can be enabled by adding <code>useX11LegacyScreenshot = true</code> to the settings configuration.

=== Multi-monitor screenshot prompt ===

When taking screenshots, Flameshot will now open a prompt on multi-monitor setups to choose a display to capture. This is contrast with the pre-v14 behaviour, where capturing was rendered across all screens. Users on X11 may disable this behaviour by enabling "Capture active monitor (skip monitor selection)" in the "General" tab Flameshot GUI config. If using Home Manager's Flameshot module, this option can be enabled by adding <code>captureActiveMonitor=true</code> to the settings configuration.

Wayland users are unable to disable this due to its security design and lack of cross-platform solutions. To circumvent this behaviour, it is recommended to change keybind from default <code>flameshot gui</code> to, for example <code>flameshot screen --edit</code>. This will capture the currently active display (wherever the cursor is) and open the GUI editor. This will occasionally incorrectly select a display, however.

=== Incorrect capture overlay render ===

Some users, most commonly on X11 window managers, may experience regressions in how screen capture is rendered, more so on multi-monitor setups. Instead of opening as an overlay, it might open as a separate window. The cause is currently unknown and solutions may vary depending on how window management is implemented by each manager.

[[Category:Applications]]

@@ Line 88: / Line 88: @@
    };
 };|name=/etc/nixos/home.nix|lang=nix}}
+== Troubleshooting ==
+With the release of v14.0.0 of Flameshot, users may experience several issues depending on their setup. This section will cover most common situations and their solutions.
+=== Unable to take a screenshot: portal timed out/screenshot aborted ===
+By default, Flameshot now uses XDG desktop portal calls for screenshotting. This necessitates having <code>xdg-desktop-portal</code> + portal(s) with Access and Screenshot interfaces installed (see ArchWiki's [https://wiki.archlinux.org/title/XDG_Desktop_Portal#List_of_backends_and_interfaces Portal Backends] list). Without those, screenshot attempts will fail.
+Users on X11 window managers will be unable to use the default method; no portal provides a Screenshot interface there. The solution is to enable "Use legacy X11 screenshot" method located in the "General" tab of Flameshot GUI config. If using Home Manager's Flameshot module, this option can be enabled by adding <code>useX11LegacyScreenshot = true</code> to the settings configuration.
+=== Multi-monitor screenshot prompt ===
+When taking screenshots, Flameshot will now open a prompt on multi-monitor setups to choose a display to capture. This is contrast with the pre-v14 behaviour, where capturing was rendered across all screens. Users on X11 may disable this behaviour by enabling "Capture active monitor (skip monitor selection)" in the "General" tab Flameshot GUI config. If using Home Manager's Flameshot module, this option can be enabled by adding <code>captureActiveMonitor=true</code> to the settings configuration.
+Wayland users are unable to disable this due to its security design and lack of cross-platform solutions. To circumvent this behaviour, it is recommended to change keybind from default <code>flameshot gui</code> to, for example <code>flameshot screen --edit</code>. This will capture the currently active display (wherever the cursor is) and open the GUI editor. This will occasionally incorrectly select a display, however.
+=== Incorrect capture overlay render ===
+Some users, most commonly on X11 window managers, may experience regressions in how screen capture is rendered, more so on multi-monitor setups. Instead of opening as an overlay, it might open as a separate window. The cause is currently unknown and solutions may vary depending on how window management is implemented by each manager.
 [[Category:Applications]]