Flameshot: Difference between revisions

Phobos (talk | contribs)
m Updated Flameshot Page with a section on Shortcuts
m Multi-monitor screenshot prompt: spacing between equals sign.
 
(5 intermediate revisions by 3 users not shown)
Line 8: Line 8:


=== Install on Wayland ===
=== Install on Wayland ===
In order to use Flameshot on Wayland you will need to install [https://github.com/emersion/grim Grim] and configure Flameshot to use it.  
In order to use Flameshot on Wayland you will need to install [https://gitlab.freedesktop.org/emersion/grim Grim] and configure Flameshot to use it.  


==== Install Grim ====
==== Install Grim ====
Line 39: Line 39:


       # Save Path
       # Save Path
       savePath = "/mnt/internal/wintermute/Sync/Screenshots";
       savePath = "/home/user/Screenshots";
       # Tray
       # Tray
       disabledTrayIcon = true;
       disabledTrayIcon = true;
Line 50: Line 50:
       # Notification for cancelled screenshot
       # Notification for cancelled screenshot
       showAbortNotification = false;
       showAbortNotification = false;
      # Whether to show the info panel in the center in GUI mode
      showHelp = true;
      # Whether to show the left side button in GUI mode
      showSidePanelButton = true;
      # Whether to enable legacy (pre-xdg-desktop-portal) screenshotting on X11
      useX11LegacyScreenshot = true;
      # Whether to skip display selection prompt (X11-only)
      captureActiveMonitor = true;


       # Color Customization
       # Color Customization
Line 83: Line 92:
   };
   };
};|name=/etc/nixos/home.nix|lang=nix}}
};|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]]
[[Category:Applications]]