LinuxCommandLibrary

gnome-screenshot

Capture screen images

TLDR

Take a screenshot and save it to the default location, normally ~/Pictures

$ gnome-screenshot
copy

Take a screenshot and save it to the named file location
$ gnome-screenshot [[-f|--file]] [path/to/file]
copy

Take a screenshot and save it to the clipboard
$ gnome-screenshot [[-c|--clipboard]]
copy

Take a screenshot after the specified number of seconds
$ gnome-screenshot [[-d|--delay]] [5]
copy

Launch the GNOME Screenshot GUI
$ gnome-screenshot [[-i|--interactive]]
copy

Take a screenshot of the current window and save it to the specified file location
$ gnome-screenshot [[-w|--window]] [[-f|--file]] [path/to/file]
copy

Take a screenshot after the specified number of seconds and save it to the clipboard
$ gnome-screenshot [[-d|--delay]] [10] [[-c|--clipboard]]
copy

Display the version
$ gnome-screenshot --version
copy

SYNOPSIS

gnome-screenshot [OPTIONS]

PARAMETERS

--window
    Captures a screenshot of the currently focused window.

--area
    Allows the user to select a rectangular area of the screen to capture.

--full-screen
    Captures a screenshot of the entire screen (default behavior if no capture type is specified).

--delay=SECONDS
    Specifies a delay in seconds before the screenshot is taken, allowing time to set up the screen.

--clipboard
    Copies the screenshot directly to the system clipboard instead of saving to a file.

--file=FILENAME
    Saves the screenshot to the specified FILENAME. If not provided, a default name will be used (e.g., 'Screenshot from YYYY-MM-DD.png').

--no-border
    Excludes the border of a window when capturing a window screenshot. Only applicable with --window.

--no-shadow
    Excludes the shadow effect around a window when capturing a window screenshot. Only applicable with --window.

--no-cursor
    Hides the mouse cursor from the captured screenshot.

--interactive
    Launches the graphical user interface to interactively choose screenshot options and settings.

--version
    Displays the version information of the gnome-screenshot command.

--help
    Shows a help message with available command options.

DESCRIPTION

gnome-screenshot is a command-line utility designed for taking screenshots within the GNOME desktop environment.

It offers various options for capturing the entire screen, a specific window, or a selected area. Users can specify a delay before the screenshot is taken, include or exclude the mouse pointer, and apply visual effects like borders or shadows. The captured image can be saved directly to a file, copied to the system clipboard, or even initiated via an interactive graphical interface. It serves as the primary backend for the 'Print Screen' key functionality in GNOME.

CAVEATS

gnome-screenshot is tightly integrated with the GNOME desktop environment. While it might function on other X11-based desktops, its full capabilities and optimal performance are guaranteed within GNOME. It requires an active X session and does not provide advanced image editing functionalities.

DESKTOP ENVIRONMENT INTEGRATION

gnome-screenshot is commonly bound to the 'Print Screen' key on GNOME desktops for quick access. Combinations like Alt + 'Print Screen' typically capture the active window, and Shift + 'Print Screen' often allows for interactive area selection.

DEFAULT SAVING BEHAVIOR

By default, screenshots are saved to the user's 'Pictures' directory (or a similar user-specific image folder). The default filename format usually includes the date and time, for example: 'Screenshot from YYYY-MM-DD HH-MM-SS.png'.

HISTORY

gnome-screenshot has been a core utility of the GNOME desktop environment for many years, evolving to offer a user-friendly and integrated approach to screen capturing. Its development is aligned with the GNOME project's philosophy of simplicity and seamless desktop integration, serving as the modern replacement for older, less integrated screenshot methods within the GNOME ecosystem.

SEE ALSO

scrot(1): A simple command-line screenshot utility., import(1): From ImageMagick, a powerful utility for capturing and manipulating images from the X server., xwd(1): An X Window System window dump utility, providing basic screen capture.

Copied to clipboard