LinuxCommandLibrary

flameshot

Capture and annotate screenshots

TLDR

Create a fullscreen screenshot

$ flameshot full
copy

Create a screenshot interactively
$ flameshot gui
copy

Create a screenshot and save it to a specific path
$ flameshot gui [[-p|--path]] [path/to/directory]
copy

Create a screenshot interactively in a simplified mode
$ flameshot launcher
copy

Create a screenshot from a specific monitor
$ flameshot screen [[-n|--number]] [2]
copy

Create a screenshot and print it to stdout
$ flameshot gui [[-r|--raw]]
copy

Create a screenshot and copy it to the clipboard
$ flameshot gui [[-c|--clipboard]]
copy

Create a screenshot with a specific delay in milliseconds
$ flameshot full [[-d|--delay]] [5000]
copy

SYNOPSIS

flameshot gui|screen|full|config|version|help [options]

PARAMETERS

gui
    Interactive screenshot with region selector and annotation UI

screen
    Capture the current screen

full
    Capture all screens

config
    Open configuration dialog

-c, --clipboard
    Copy image to clipboard (for gui/screen/full)

-d, --delay <seconds>
    Delay before capture

-p, --path <path>
    Save path or filename

-k, --raw
    Capture raw image to stdin (gui only)

-r, --raw-output
    Output raw image to stdout

-s, --select
    Enable region selection

-t, --type <type>
    Image format (png, jpg)

--flash
    Flash screen after capture

-h, --help
    Show help

--version
    Print version

DESCRIPTION

Flameshot is an open-source, cross-platform screenshot software designed for Linux, Windows, and macOS. It excels in capturing screen regions, full screens, or specific monitors with a user-friendly GUI selector.

Key features include real-time annotations such as arrows, text, highlights, blurs, and pixelation directly on the capture interface. Users can save images in formats like PNG or JPEG, copy to clipboard, upload to Imgur, or print. The tool supports customizable hotkeys, delay timers, and flash effects for feedback.

Primarily GUI-driven, Flameshot offers a robust CLI for scripting and automation, making it ideal for power users. Configuration is handled via a dedicated dialog or INI file, allowing personalization of toolbar buttons, save paths, and behaviors. Its lightweight Qt-based design ensures minimal resource usage while providing advanced editing without external software.

Popular on Linux desktops like GNOME, KDE, and XFCE, Flameshot integrates well with compositors and supports X11/Wayland (with limitations on Wayland).

CAVEATS

Wayland support is partial (no region select in some compositors); requires Qt5/Qt6; config at ~/.config/flameshot/flameshot.ini; no native HiDPI scaling on all setups.

CONFIGURATION

Use flameshot config or edit ~/.config/flameshot/flameshot.ini for paths, hotkeys, toolbar settings.
Default hotkey: PrintScreen.

HOTKEY SETUP

Set global shortcuts via desktop environment (e.g., KDE: flameshot gui -p ~/Pictures). Supports custom scripts.

HISTORY

Developed by lupoDharkael and flamarion starting 2016; GitHub project (flameshot-org/flameshot) gained popularity for annotation features; v12+ added Wayland, config GUI; now v13.x with active community contributions.

SEE ALSO

scrot(1), gnome-screenshot(1), maim(1), grim(1)

Copied to clipboard