GNOME Screenshot
GNOME Screenshot is a free and open-source utility designed for the GNOME desktop environment, enabling users to capture screenshots of the entire desktop, the currently focused window, or a user-defined area of the screen.[1] It provides options to include or exclude the mouse cursor in captures, apply decorative border effects to window screenshots, and output the image by saving it to a specified file, copying it to the clipboard, or opening it in an image editor.[2] Developed initially as part of the GNOME Utilities package, GNOME Screenshot evolved into a standalone tool within the GNOME Core Applications, supporting X11-based systems with dependencies on GLib 2.36 and GTK+ 3.12.[3] The application received updates through multiple releases, with the final version 41.0 issued in 2021. However, it is now unmaintained, as GNOME Shell integrated native screenshot and screencast capabilities starting with GNOME 42 in March 2022, rendering the separate utility obsolete.[4][5]Overview
Purpose and functionality
GNOME Screenshot is a utility for the GNOME desktop environment that enables users to capture screenshots of the entire desktop, a single window, or a selected area of the screen.[1] Its primary function involves saving the captures as PNG files by default, while also providing an option to copy the image directly to the clipboard for immediate use in other applications.[6][7] Within the GNOME desktop environment, GNOME Screenshot was designed to address basic screenshot needs through keyboard shortcuts, such as Print Screen for full-screen captures, or manual invocation via the command line or graphical interface.[2] The basic workflow allows a user to select the desired capture mode, apply optional delays for timed shots or visual effects like borders and shadows if needed, and then output the resulting image to a specified location or the clipboard.[7] This straightforward process enables quick documentation of on-screen content without requiring advanced configuration.[8]Current status
GNOME Screenshot reached its final release with version 41.0 on November 13, 2021.[9] Following this, the tool was removed from the core GNOME applications starting with GNOME 42 in March 2022, marking the end of active maintenance by the GNOME Project.[5] In September 2025, with the release of GNOME 49, access to the private screenshot API was revoked, rendering the standalone gnome-screenshot non-functional under Wayland sessions in modern GNOME environments. It may still operate under X11 sessions, although X11 support is deprecated.[10][11] The deprecation stemmed from GNOME's transition to integrated, portal-based screenshot and screen recording tools within GNOME Shell, which enhance security by leveraging the XDG Desktop Portal API and improve compatibility with Wayland sessions.[5] While the package remains installable through repositories on older Linux distributions, its deployment is not recommended for contemporary setups due to these incompatibilities and lack of support.[11]History
Origins in GNOME Utilities
GNOME Screenshot originated as part of the gnome-utils package, a collection of utilities for the early GNOME desktop environment (starting with GNOME 1.0 in 1999). The gnome-utils package served as a collection of essential utilities designed to enhance productivity and usability within the emerging GNOME ecosystem, including tools like a simple calculator (gcalc), a clock (gclock), and basic file management aids, with gnome-screenshot providing straightforward screen capture functionality to complement these. This inclusion reflected GNOME's early emphasis on delivering a cohesive set of graphical applications for Unix-like systems, where command-line tools like xwd dominated screenshot tasks, aiming to standardize and simplify such operations through a user-friendly interface.[12] In its initial form, gnome-screenshot supported basic full-screen captures via a minimal GTK-based graphical interface, capturing the entire display and saving it in common image formats to align with GNOME's goals for accessible desktop interactions.[1] Developed primarily for X11-based displays, the tool relied on core GNOME libraries to ensure compatibility with the desktop's visual and event-handling systems, filling a gap for intuitive screenshot handling without requiring terminal commands.[13] During the early 2000s, minor updates within gnome-utils improved stability and integration with GNOME components, though the core functionality remained focused on simplicity.[14] By the GNOME 2.x series, starting around 2002, gnome-screenshot had matured into a reliable utility, offering enhanced stability for X11 environments and integration with evolving GNOME components, such as improved dialog boxes for capture options. It continued to embody the suite's role in providing lightweight, essential tools until its separation into an independent package in 2011.Independent development
In October 2011, GNOME Screenshot was separated from the gnome-utils package and released as version 3.3.1 as a standalone project, marking the first unstable release of its independent cycle and enabling more modular maintenance separate from the broader utilities suite.[15] The project underwent incremental updates across the GNOME 3.x series and into the 40.x series, with key enhancements including UI redesigns, fixes for area selection flashing and HiDPI rendering on X11 in version 3.33.90, and the addition of timeout options for area screenshots alongside deprecation of border effects in version 3.37.1.[16] Following GNOME's broader migration from GitHub to GitLab in May 2018, the gnome-screenshot repository has been hosted there, facilitating ongoing collaboration.[17] Development was led by GNOME contributors, with primary author Giannis Antypas overseeing maintenance, emphasizing tight integration with the GTK toolkit for consistent theming and behavior, as well as compatibility across X11 and emerging desktop protocols.[1] Prior to its deprecation, versions up to 41.0 (released November 2021) incorporated Wayland support through options like the -Dx11 build flag introduced in 3.37.1, which removed X11 dependencies to enable operation under Wayland compositors, though functionality remained more comprehensive on X11 due to protocol limitations.[16]Deprecation and replacement
GNOME Screenshot was effectively deprecated with the introduction of a redesigned, built-in screenshot and screen recording tool in GNOME Shell as part of the GNOME 42 release in March 2022, with the official release notes recommending the use of this integrated portal UI for capturing screenshots.[5] The primary technical rationale for deprecation involved the tool's longstanding dependence on private APIs within GNOME Shell, which proved incompatible with evolving security architectures, including the shift to Wayland as the default session and the adoption of PipeWire for media handling. These dependencies hindered secure, portal-based screen capture in modern environments, and in GNOME 49—released on September 17, 2025—access to the private screenshot API was deliberately revoked to enforce stricter security boundaries, as the standalone tool was no longer considered part of GNOME's core applications.[11][1][18] The revocation in GNOME 49 resulted in widespread breakage for existing installations, preventing the tool from capturing screens under Wayland sessions and prompting major distributions to excise it from default configurations; for instance, Ubuntu 25.10, which ships with GNOME 49, no longer includes GNOME Screenshot in its standard package set, directing users to the Shell's native functionality instead.[19][11] Community reactions have centered on adaptation rather than restoration, with discussions in project repositories highlighting forks and rewrites to sustain the tool for non-GNOME environments, such as the Cinnamon desktop used in Linux Mint, where it remains a dependency; for example, Linux Mint has initiated a rewrite called Clicky.[20] However, no official efforts to revive or maintain GNOME Screenshot within the GNOME ecosystem have materialized, reflecting the project's focus on integrated solutions.Technical details
Programming and dependencies
GNOME Screenshot is implemented primarily in the C programming language, leveraging its low-level capabilities for efficient image capture and manipulation operations.[21] The application's graphical user interface is constructed using the GTK toolkit, with earlier releases depending on GTK 2 and later versions adopting GTK 3 to integrate seamlessly with the GNOME desktop environment's theming and widget standards.[3] Key dependencies include GLib (version 2.36 or later) for internationalization, file handling, and utility functions; GDK for managing windows, events, and pixbuf image operations; and backends supporting the X11 display server for screen access.[1][3] However, due to reliance on X11-specific APIs, it has limited compatibility with Wayland and does not work reliably in GNOME versions 42 and later.[22][23] Additional libraries such as libcanberra for audio feedback and libhandy for adaptive UI elements on mobile form factors are also required. For screenshot output in PNG format, it relies on GDK Pixbuf's integration with libpng.[3] The project uses the Meson build system, which was adopted starting around GNOME 3.26 to replace the prior autoconf setup, enabling faster and more portable compilation; the source code is maintained in a public repository on GitLab.[24][1]License and distribution
GNOME Screenshot is released under the GNU General Public License version 2.0 or later (GPL-2.0-or-later), which permits users to freely use, study, modify, and redistribute the software, provided that derivative works adhere to the same licensing terms.[25] This open-source license aligns with the broader GNOME project's commitment to free software principles, enabling community contributions and adaptations while ensuring the source code remains accessible.[26] The tool is widely distributed through official packages in major Linux distributions, such as Debian and Ubuntu where it is available via theapt package manager as gnome-screenshot, and in Arch Linux, Gentoo, and openSUSE repositories.[27][28] Source code releases are provided through the GNOME GitLab repository, with tagged versions up to 41.0, and tarballs available via the GNOME FTP servers for manual compilation and integration into custom environments.
Designed primarily for Unix-like systems, GNOME Screenshot provides pre-built binaries for various Linux architectures through distribution repositories, but lacks official ports for Windows or macOS; however, its C-based implementation with GTK dependencies allows compilation on compatible platforms with appropriate libraries.[26][28] Since 2021, the upstream repository has been unmaintained and placed in read-only status following its deprecation in favor of integrated GNOME Shell features, though Linux distributions continue to provide updated packages with security patches and compatibility fixes for legacy users.[1][29]
Features
Capture options
GNOME Screenshot provides several modes for capturing specific parts of the desktop environment. The full screen capture option grabs the entire desktop display, serving as the default mode when invoked without additional parameters or via the Print Screen (PrtSc) keyboard shortcut.[2][30] For window capture, the tool targets the currently active window or a user-selected one, activated by the Alt+PrtSc shortcut or the --window command-line flag; window captures include decorations such as borders and title bars (the --include-border and --remove-border options are deprecated).[2][31] Area selection enables users to define a custom rectangular region via an interactive crosshair cursor, triggered by Shift+PrtSc or the --area flag, which prompts for dragging to specify the precise boundaries.[2][30] Additionally, GNOME Screenshot includes a toggle for cursor inclusion, enabled via the --include-pointer (-p) flag or a configurable preference, which overlays the mouse pointer in the capture—particularly useful for tutorial or instructional screenshots where pointer position provides context; by default, the cursor is excluded to avoid clutter.[32][31]Additional settings
GNOME Screenshot offers several customization options in its graphical user interface that allow users to modify the capture process and output, enhancing flexibility for timed shots, visual enhancements, and handling of the resulting image. These settings are accessible upon launching the application without command-line arguments, presenting a dialog for selecting capture type, applying modifiers, and confirming the result.[33] The delay timer feature enables users to set a configurable countdown period before the screenshot is taken. This allows time to arrange windows, open menus, or position the cursor as needed for the desired composition. For instance, selecting a 5-second delay provides ample setup without interrupting workflow.[2][33] Image effects can be applied post-capture to add visual polish, including a border option that inserts a rectangular frame around the screenshot, a shadow effect that simulates a drop shadow for depth, or a vintage effect that slightly desaturates the image (these effects are deprecated in version 41.0). These enhancements are selected via a dropdown menu in the GUI and are rendered automatically after the capture, aiding in presentations or annotations. The default is no effect, preserving the raw image.[2][31][31] Output choices include saving the screenshot as a PNG file to the default location of ~/Pictures/Screenshots, with filenames timestamped for uniqueness (e.g., Screenshot from 2021-11-13 14-30-00.png). Users can also opt to copy the image directly to the clipboard for immediate pasting into other applications, or select both actions simultaneously via checkboxes or buttons in the preview dialog. This dual functionality supports quick sharing without altering the save behavior.[33][34] Interactive mode is invoked by default in the GUI, displaying a preview window immediately after capture for user confirmation. This window shows the captured image with applied effects and delay results, allowing review before finalizing the save or clipboard copy, thus preventing unintended captures from being stored.[2][33]Usage
Graphical user interface
GNOME Screenshot launches a modal graphical dialog when invoked from the GNOME applications menu via the Activities overview, through configured keyboard shortcuts such as the Print Screen key in GNOME versions prior to 42, or by executing thegnome-screenshot command in a terminal without arguments (as default shortcuts now use the built-in GNOME Shell tool in newer versions).[2] This interactive interface, built using GTK+, provides a straightforward window for configuring and capturing screenshots.[1]
The dialog includes radio buttons for selecting the capture type: full screen, current window, or a user-selected area. Checkboxes allow options such as including the mouse cursor and setting a delay in seconds before capture. A central preview pane displays the resulting screenshot immediately after capture for review.[6][2]
To use the interface, users select their preferred capture type and toggle additional settings as needed, then click the "Take Screenshot" button to perform the capture. The preview then appears, offering buttons to save the image to a file (with a file chooser dialog for location and name), copy it to the clipboard, or discard it. The dialog adheres to the current GNOME theme for visual consistency with the desktop environment.[6]
This GUI remains basic, lacking built-in tools for image editing or annotation. GNOME Screenshot is deprecated and unmaintained, with modern GNOME versions favoring portal-based popup interfaces for screenshots.[1][35] Alternatively, non-interactive captures can be performed via the command-line interface for scripted use.[2]
Command-line interface
The command-line interface of GNOME Screenshot enables non-interactive screenshot capture, suitable for automation and scripting in terminal environments. Invoked asgnome-screenshot [options], it defaults to capturing the entire screen and saving the image as a PNG file in the user's Pictures directory with a timestamped name, such as "Screenshot from 2025-11-13 14-30-00.png".[36]
Key options allow customization of capture mode, output, and timing. The -w or --window flag captures the currently focused window instead of the full screen. The -a or --area flag prompts selection of a rectangular area via mouse drag. For delayed capture, -d SECONDS or --delay=SECONDS waits the specified number of seconds before taking the screenshot, useful for including menus or transient UI elements. Output can be directed to the clipboard with -c or --clipboard, bypassing file saving, or to a custom path using -f FILENAME or --file=FILENAME. The -p or --include-pointer option includes the mouse cursor in the capture. Note that -e EFFECT or --effect=EFFECT for adding visual effects like shadows or borders is deprecated and defaults to none, as effects are no longer supported.[36][2]
Examples demonstrate practical usage. To capture the active window and copy it to the clipboard: gnome-screenshot -w -c. For a full-screen screenshot saved to a specific file after a 3-second delay: gnome-screenshot -d 3 -f ~/screenshots/manual.[png](/page/PNG). These commands integrate seamlessly into shell scripts for batch processing, such as looping over multiple windows or automating timed captures in cron jobs.[37][38]
The tool returns an exit code of 0 upon successful capture and saving or copying, and 1 for errors such as invalid options, unsupported modes, or failures in area selection. This behavior facilitates error handling in scripts, for instance, via conditional checks like if gnome-screenshot -w; then echo "Success"; else echo "Failed"; fi.[36]