flameshot-org / flameshot

Flameshot
 Powerful yet simple to use screenshot software. 
## Preview
## Index
- Features
- Usage
 - Usage on Windows
 - Usage on Hyprland / Sway / wlroots
 - Usage on minimal X11 window managers
 - CLI configuration
 - Config file
- Keyboard Shortcuts
 - Local
 - Global
 - On KDE Plasma desktop
 - On Gnome (Ubuntu, Fedora and more)
 - On XFCE 4
 - On Fluxbox
- Considerations
- Installation
 - Prebuilt Packages
 - Packages from Repository
 - MacOS
 - Windows
- Compilation
 - Dependencies
 - Compile-time
 - Run-time
 - Optional
 - Debian
 - Fedora
 - Arch
 - Build
 - Install
- License
- Privacy Policy
- Code Signing Policy
- Contribute
- Acknowledgment
## Features
- Customizable appearance.
- Easy to use.
- In-app screenshot editing.
- DBus interface.
- Upload to Imgur.
## Usage
Executing the command `flameshot` without parameters will launch a running
instance of the program in the background without taking actions.
If your desktop environment provides tray area, a tray icon will also
appear in the tray for users to perform configuration and management.
Example commands:
- Capture with GUI:
 [code] 
- Capture with GUI with custom save path:
 [code] 
- Capture with GUI after 2 seconds delay (can be useful to take screenshots of mouse hover tooltips, etc.):
 [code] 
- Fullscreen capture with custom save path (no GUI) and delayed:
 [code] 
- Fullscreen capture with custom save path copying to clipboard:
 [code] 
- Capture the screen containing the mouse and print the image (bytes) in PNG format:
 [code] 
- Capture the screen number 1 and copy it to the clipboard:
 [code] 
In case of doubt choose the first or the second command as shortcut in your favorite desktop environment.
A systray icon will be in your system's panel while Flameshot is running.
Do a right click on the tray icon and you'll see some menu items to open the configuration window and the information window.
Check out the About window to see all available shortcuts in the graphical capture mode.
### Usage on Windows
On Windows, `flameshot.exe` will behave as expected for all supported command-line arguments, 
but it will not output any text to the console. This is problematic if, for example, you are 
running `flameshot.exe -h`.
If you require console output, run `flameshot-cli.exe` instead. `flameshot-cli.exe` is a minimal wrapper around `flameshot.exe` that ensures all stdout is captured and output to the console.
### Usage on Hyprland / Sway / wlroots
Please refer to this document for detailed instructions on how to set up Flameshot on Hyprland, Sway, and wlroots-based Wayland compositors.
### Usage on minimal X11 window managers
On minimal X11 window managers (i3, dwm, xmonad, bspwm, ...), capturing may fail because no portal backend implements the Screenshot interface (errors such as *"Could not locate the org.freedesktop.portal.Desktop service"* or *"Screenshot portal timed out"*). Please refer to this document for the fix (enabling the legacy X11 capture).
### CLI configuration