How to Capture a Screenshot From the Command Line (Windows, Linux and macOS)

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

The right command depends on your operating system and, on Linux, whether your desktop is using X11 or Wayland. For an X11 desktop, ImageMagick can save the full root window with magick import -window root screen.png. GNOME users can use gnome-screenshot for a screen, window or selected area. Windows offers an interactive Snipping Tool protocol, a .NET screen-copy API for application code, and Microsoft GDK’s wdcapture.exe for documented SDR/HDR command-line capture. macOS syntax is version-specific; use the screencapture manual installed on your Mac rather than copying an unverified flag list.

Choose the capture method before you type a command

A “command-line screenshot” can mean three different things:

#	Preview	Product	Price
1		Guermok Video Capture Card, 4K USB3.0 HDMI to USB C, 1080P 60FPS & 2K 30FPS	$18.99	Buy on Amazon
2		Audio Express AXHDCAP 4K HDMI Video Capture Card, Cam Link Card Game Audio Adapter HDMI to USB 2.0...	$9.98	Buy on Amazon
3		Video Capture Card, 4K USB3.0 HDMI to USB C, 1080P60FPS HDMI Capture Card for Streaming, Gaming,...	$15.99	Buy on Amazon
4		Capture Card, 4K HDMI Video Capture Card, Game Capture Card, 1080P 60FPS Video Capture Device, HDMI...	$25.89	Buy on Amazon
5		Capture Card, USB Video Capture Card Device, Audio Video Converter Grabber for RCA to USB-Convert...	$12.99	Buy on Amazon

• Unattended desktop capture: a command saves pixels directly to a file, suitable for scripts and scheduled jobs.
• Interactive capture: a command opens a selection overlay and waits for you to choose a rectangle, window or freeform shape.
• Application code: a program calls a screen-capture API and writes the resulting bitmap.

Use the following decision table to avoid running a command that cannot work in your session.

Linux: capture an X11 screen with ImageMagick

Full-screen X server capture

Install ImageMagick through your distribution, then run:

#1 Best Overall

Guermok Video Capture Card, 4K USB3.0 HDMI to USB C, 1080P 60FPS & 2K 30FPS

• 【1080P 60FPS Video Capture Card】 This HDMI game capture card is based on USB3.0 high speed transmission port, input resolution up to 4K@30HZ, output resolution up to 2K@30Hz or 1920×1080@60Hz. Type c and USB interface can meet most of the devices in daily life. Easily meet the online capture, real-time recording, online meetings, live gaming and other functions, so you have a better visual enjoyment. Note: For capture use only; requires capture software to function and is not intended for direct screen casting to a monitor or TV
• 【Ultra Low Latency Screen Sharing】 HDMI capture card is made of good quality aluminum alloy with strong heat dissipation, allowing you to enjoy ultra low latency while live gaming or video recording or live streaming, avoiding blue screens and lag. This HDMI to USBC capture card supports easy recording of good quality audio or HD video and transferring it to your computer or streaming platform, allowing you to record 60 fps HD video directly on your hard drive and real-time preview
• 【Plug and Play, Easy to Carry】 This HDMI 1080P video capture card does not require any additional drivers or external power supply, just plug and play for fast capture. The capture card is small and lightweight, so you can put it in your bag for emergencies, making it very portable for outdoor live streaming. It's also a great way to share content in game recording, video conference, video recorder and online teaching
• 【Wide Compatibility USB Capture Card】 Easily streams to Facebook, Youtube or Twitch. With the connection, this HDMI to USB C/3.0 video capture devices can be working on several Operating Systems and various software: Windows 7/ 8/ 10, Mac OS or above, Linux, Android, Laptop, Xbox One, PS3/PS4/PS5, Camera, DVDs, Set Top Box, Webcame, DSLR, Switch/Switch 2, TV BOX, HDTV, Potplayer/VLC, ZOOM, OBS Studio etc.
• 【Package Content & Note】 1x HD Audio Capture Card , 1x USB 3.0 to USB C Adapter (A-side 3.0, B-side 2.0), 1x user manual. Please note that you need to restart the OBS Studio software after the audio setup is complete, otherwise it will result in no sound output. When using an adapter, if the device is recognized as USB 2.0, try using the other side with the USB-C port. Simply flip the capture card and reconnect it to be recognized as USB 3.0

$18.99

Buy on Amazon

magick import -window root screen.png

-window root selects the X server’s root window, and screen.png is the output file. The official ImageMagick example uses PostScript, but import writes other image formats when the filename identifies the desired format. Choose a path you can write to, such as $HOME/Pictures/screen.png.

This captures the X screen visible to the process. It is not a universal Linux command: a Wayland session may not expose an X server screen for import to read. If the command reports that it cannot open a display, confirm that the shell is running inside the graphical session and that ImageMagick can reach that session’s X server.

Select a window or rectangular area interactively

Run:

magick import selection.png

ImageMagick prompts you to click or drag a selection. You can also select a window by clicking it when prompted. The resulting file is written when the selection is completed.

What the X11 root-window option actually includes

ImageMagick documents root-window capture through its -screen and root-window options. The result can include portions of other windows that cover the selected window, and independent menus or popups can be captured. That behavior is useful when you need what is currently composited on the X desktop, but it is different from asking an application for its private backing buffer. See the ImageMagick command-line options documentation for the option semantics.

Useful checks when ImageMagick fails

• Run magick -version to confirm the executable is installed and identify the build.
• Check that the shell belongs to the logged-in graphical session; a remote, service or elevated shell may not have access to the display.
• Try the interactive command first. If it also cannot open a display, the problem is session access rather than the output format.
• If the desktop is Wayland-only, use a capture utility intended for that compositor or switch to an application/API approach; do not present the X11 command as a Wayland solution.

Linux GNOME: screen, window, area and delay

The Debian unstable gnome-screenshot(1) manual describes these modes:

• gnome-screenshot captures the whole screen by default.
• gnome-screenshot -w or --window captures the active window.
• gnome-screenshot -a or --area lets you select an area.
• gnome-screenshot -d SECONDS or --delay=SECONDS waits before capturing, where that option is present in the installed version.

For example:

gnome-screenshot -w

gnome-screenshot -a

gnome-screenshot -d 5

The utility chooses a default filename and location unless you provide the output options supported by your build. Because the cited manual is for Debian unstable, run gnome-screenshot --help on your own machine before putting a flag into a script. Distribution packages can expose a different option set or version.

Rank #2

Audio Express AXHDCAP 4K HDMI Video Capture Card, Cam Link Card Game Audio Adapter HDMI to USB 2.0 Record Capture Device for Streaming, Live Broadcasting, Video Conference, Teaching, Gaming

• [Enhanced 4K-1080P Video Capture Experience] Capture the Magic: Elevate your video recordings to new heights with our upgraded anti-static 1080P Video Capture Card. Immerse yourself in stunning visuals, supporting HDMI input at 4K 60FPS and USB output for capturing in 1080P, complete with rich stereo sound. Enjoy crystal-clear video recordings, dynamic gaming live streams, and professional conference broadcasts. Note: HDMI resolution: Max input can be 3840×2160@30Hz / Video output resolution: Max output can be 1920×1080@30Hz
• [Seamless Real-Time Preview] Stay in the Moment: Our advanced ultra-low latency technology ensures seamless real-time transmission of video streams. Experience instant, lag-free previews, allowing you to capture every detail precisely. Effortlessly record video directly to your hard disk, all without compromising on quality or introducing any delays.
• [Versatility and Broad Compatibility] Your Creative Hub: Connect your DSLR, camcorder, or action camera to a wide range of operating systems, including Windows, MacOS, and Linux. Unlock a world of possibilities with real-time streaming to popular platforms like Twitch, Youtube, OBS, Zoom, Potplayer, and VLC, giving you the tools to share your content effortlessly.
• [Effortless Plug and Play] Simplicity Redefined: Say goodbye to complex installations. Our plug-and-play design eliminates the need for drivers or external power supplies. Seamlessly integrate high-definition acquisition into various scenarios, whether it's educational recordings, immersive gaming, precise medical imaging, captivating live streams, or professional broadcasting.
• [Seize Every Detail with Precision] Unleash your creativity and attention to detail with our video capture card. Capture every nuance, every color, and every moment with precision, thanks to the enhanced capabilities of our technology. Whether you're a content creator, a gamer, or a professional, our capture card empowers you to seize the finest elements and bring them to life in your recordings and live streams.

$9.98

Buy on Amazon

Making GNOME captures scriptable

Use an explicit destination only after confirming its spelling in local help. Keep the command in the same graphical login as the target desktop; running it from a headless SSH connection does not automatically grant access to the GNOME session. For repeatable jobs, record the utility version, desktop session and output path alongside the script.

Windows: interactive Snipping Tool, application code and GDK

Snipping Tool protocol for an interactive overlay

Microsoft documents launching Snipping Tool with the ms-screenclip: protocol. It supports rectangle, freeform and window modes, and the URI requires exactly one mode parameter. Use Microsoft’s Launch Snipping Tool documentation for the current URI spelling and mode values for your Windows release.

This route opens the capture interface and waits for a person to finish the selection. It should not be described as a background command that silently writes a predetermined filename. If your automation requires a file with no UI, use application code or a capture tool designed for unattended operation instead.

Capture pixels from a Windows Forms application with .NET

For software you control, Microsoft’s Graphics.CopyFromScreen API copies pixels from a screen rectangle to a drawing surface. This minimal Windows Forms example captures a 1,920 × 1,080 rectangle beginning at the primary screen’s origin and saves a PNG:

using System.Drawing;
using System.Drawing.Imaging;

class Capture
{
    static void Main()
    {
        const int width = 1920;
        const int height = 1080;
        using var bitmap = new Bitmap(width, height, PixelFormat.Format32bppArgb);
        using (var graphics = Graphics.FromImage(bitmap))
        {
            graphics.CopyFromScreen(0, 0, 0, 0,
                new Size(width, height),
                CopyPixelOperation.SourceCopy);
        }
        bitmap.Save("screen.png", ImageFormat.Png);
    }
}

The rectangle must match the display coordinates and dimensions you intend to capture. Multi-monitor layouts can have negative coordinates or a different virtual-screen size, so hard-coding 1,920 × 1,080 is only an example. In production code, obtain the display bounds from your Windows UI framework and handle permission, session and scaling behavior appropriate to the application.

Microsoft GDK’s wdcapture.exe

Microsoft’s Screen Capture (wdcapture.exe) documentation covers a PC command-line utility built on Windows Graphics Capture APIs. Its documented output is PNG for SDR and JXR for HDR. The tool is described in the Microsoft Game Development Kit context, so verify that the GDK and executable are installed before recommending it to a general Windows machine. Use the command syntax and switches in that version’s documentation rather than assuming the executable is part of ordinary Windows.

Rank #3

Video Capture Card, 4K USB3.0 HDMI to USB C, 1080P60FPS HDMI Capture Card for Streaming, Gaming, Video Recording Compatible with Switch, Xbox, PS4/5, OBS,iPad Mac OS Windows,Camera, Zoom(Silver)

• 【4K HDMI Input, 2K@30Hz Recording】Powered by a true USB 3.0 high-speed interface, the capture card supports up to 4K@30Hz HDMI input and records at 2K@30Hz or 1080P@60Hz. Perfect for gamers, streamers, and professionals who need crisp, smooth video for live streaming, gameplay recording, or online meetings.
• 【Ultra Low Latency Screen Sharing】Built with a premium aluminum alloy shell and advanced chipset for stable heat dissipation, ensuring ultra-low latency transmission. Capture high-quality video and dual-channel audio in real time—no lag, no frame drop—ideal for Twitch, YouTube, or OBS streaming.
• 【Easy Plug and Play, Compact & Portable】No driver or external power required—just plug and play via USB 3.0 or Type-C connection to your Windows or macOS computer. Lightweight and compact design makes it easy to carry for outdoor streaming, live shows, or mobile recording setups.
• 【Wide Compatibility & Multi-Device Support】Compatible with Windows 7 8 10 11, macOS, Linux,Android and supports most popular software such as OBS, Zoom, VLC, Twitch Studio, and more. Works seamlessly with PS4, PS5, Xbox, Switch, DSLR cameras, TV boxes, and other HDMI-output devices for streaming to YouTube, Twitch, etc.
• 【What You Get】Includes: HDMI Capture Card, USB 3.0 to USB-C Adapter, User Manual. Tips: Make sure your tablet’s OTG function is enabled before connecting. Test your HDMI device with a monitor first to confirm video and audio output, then connect to the Video Capture Card for recording.

$15.99

Buy on Amazon

macOS: verify the installed screencapture interface

The exact current macOS screencapture flags were not established by the documentation used for this article. macOS releases can change command behavior, and a command copied from an older blog may silently fail or capture the wrong target. Open Terminal and read the manual page shipped with your system:

man screencapture

Use the syntax and permissions described there for your macOS version. This is safer than presenting a guessed command as universal. Test the command while logged into the desktop that should be captured; a shell running without access to that user session cannot produce the same result as an interactive Terminal window.

Compare methods by the job you need to automate

For local desktop pixels, choose the row that matches the active display session. For a web page, a browser-rendered capture service is a different problem: it loads a URL in an isolated browser instead of copying your monitor.

Or skip the browser setup

If what you really need is a screenshot of a website, ScreenshotNeo returns a PNG, JPEG, WebP or PDF from one GET request. It is not a replacement for capturing your local desktop, but it avoids installing a browser, managing display sessions and scripting consent dialogs.

cURL (the API documentation is at screenshotneo.com/docs/):

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Python:

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)

Node.js:

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

Options for repeatable website captures

ScreenshotNeo exposes the controls developers typically need:

Rank #4

Capture Card, 4K HDMI Video Capture Card, Game Capture Card, 1080P 60FPS Video Capture Device, HDMI to USB 3.0 Capture Card for Streaming, Work with Camera/Xbox/PS4/PS5/PC/OBS

• 【1080P HD High Quality】Capture resolution up to 1080p for video source and it is ideal for all HDMI devices such as PS4, PS3, Xbox One, Xbox 360, Wii U, DVDs, DSLR, Camera, Security Camera and set top box. Note: Video input supports 4K30/60Hz and 1080p120/144Hz. Does not support 4K120Hz/144Hz. Output supports up to 2K30Hz.
• 【Plug and Play】No driver or external power supply required, true PnP. Once plugged in, the device is identified automatically as a webcam. Detect input and adjust output automatically. Won't occupy CPU, optional audio capture. No freeze with correct setting.
• 【Compatible with Multiple Systems】suitable for Windows and Mac OS. High speed USB 3.0 technology and superior low latency technology makes it easier for you to transmit live streaming to Twitch, Youtube, Facebook, Twitter, OBS, Potplayer and VLC.
• 【HDMI LOOP-OUT】Based on the high-speed USB 3.0 technology, it can capture one single channel HD HDMI video signal. There is no delay when you are playing game live.
• 【Support Mic-in for Commentary】Rybozen capture card has microphone input and you can use it to add external commentary when playing a game. Please note: it only accepts 3.5mm TRS standard microphone headset.

$25.89

Buy on Amazon

• Page and viewport: full-page capture with lazy images loaded, a single element by CSS selector, 12 device presets, arbitrary viewport dimensions, retina scale, dark mode and transparent backgrounds.
• Output: PNG, JPEG or WebP screenshots; image resizing; and PDF with paper size, margins, landscape orientation and page ranges.
• Page interaction: custom CSS and JavaScript, click an element before capture, hide selectors, and wait for a selector, a delay or network idle.
• Network and identity: block ads, trackers, requests or resource types; send custom headers, cookies, a user agent and Authorization; and set timezone or geolocation.
• Delivery and scale: caching with a TTL you choose, signed links for public <img> tags, asynchronous jobs with signed webhooks, bulk capture of up to 100 URLs per call, a usage API and an OpenAPI specification.
• Migration: parameter names used by other screenshot APIs also work, which reduces changes when switching.

Before capture, it accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups and chat widgets. Each cleanup step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads and cache hits cost nothing; response headers identify the page result with X-Page-Verdict and billing with X-Billed.

An MCP server supplies take_screenshot, get_page_info and capture_pdf tools to Claude, Cursor and other MCP clients, so an AI agent can request a capture without you writing browser automation.

Plans and cost

Yearly billing provides two months free, and every feature is available on every plan. Create a free ScreenshotNeo account to get 1,000 screenshots a month with no card.

Troubleshooting command-line captures

“Unable to open display” or a blank ImageMagick file

The process cannot reach the X server, or the target desktop is not an X11 session. Run the command from the logged-in graphical session, confirm ImageMagick is installed, and identify whether the desktop is Wayland. Do not solve a Wayland mismatch by repeatedly changing the output extension; the display protocol is the issue.

GNOME flags are rejected

Your distribution may ship a different gnome-screenshot release than the Debian unstable manual. Run gnome-screenshot --help and adapt the script to the options actually installed. Keep a version check in deployment documentation.

Windows opens a selection UI when automation needs a file

That is the documented Snipping Tool behavior. Replace it with a program using Graphics.CopyFromScreen, or use wdcapture.exe only where the Microsoft GDK requirement is satisfied. Neither choice should be presented as a universal Windows shell command without checking its environment.

The .NET image is the wrong size or monitor

CopyFromScreen copies the rectangle you provide. Discover the actual virtual-screen bounds in your application instead of assuming 1,920 × 1,080, and account for multi-monitor coordinates and display scaling before saving the bitmap.

Best Value

Capture Card, USB Video Capture Card Device, Audio Video Converter Grabber for RCA to USB-Convert VHS Mini DV VCR Hi8 DVD to Digital, for PC TV Tape Player Camcorder, MAC Windows Vista Compatible

• AV TO USB Converter: Capture videos and audios from VHS, VCR, Hi8, DV tapes to a PC, with the help of our USB Video Converter. Save room while digitizing your favorite old memories
• Quality Capture Card: Our USB Video Capture Card converting anolog RCA composite input into HD 720P USB output and capturing audio without any sound card. Advanced signal processing technology provides you with great precision, colors, resolutions, and details.
• Plug and Play: Automatically install the driver once you hook up this RCA to USB Converter to a PC. No external power is needed. User-friendly and easy to operate
• Wide Compatibility: The Video Capture Card can work with video devices with RCA connector or S-Video connector, such as VHS, VCR, Hi8, camcorder, compatible with Windows and Mac OS. Support video formats like NTSC, PAL, and support brightness, contrast, hue, and saturation control
• Note: The Video Converter is used with acquisition software. We recommend OBS Studio or PotPlayer for Windows, and QuickTime Player for Mac. They can be downloaded for free online. Please operate according to the steps in User Manual or contact us if you have any questions

$12.99

Buy on Amazon

The website capture is clean locally but not in an API response

Check the response’s X-Page-Verdict and X-Billed headers, then adjust wait conditions, cookies, custom headers, user agent, geolocation or blocked resources. A bot check, blank page, timeout or failed load is not billed by ScreenshotNeo, while a cache hit is also free.

The command works manually but fails in a scheduled job

Scheduled jobs often run outside the interactive desktop session. Record the OS, display protocol, utility version, output directory and permissions. For website images, use an HTTP API instead of depending on a logged-in monitor session.

Operational notes for reliable scripts

• Make the target explicit: distinguish full screen, active window and user-selected area in the script name and documentation.
• Use deterministic paths: write to an absolute path and check that the file exists after the command exits.
• Preserve format requirements: use PNG when lossless desktop text matters; use the GDK-documented JXR output when HDR is the requirement.
• Capture the environment: OS release, Linux display protocol, desktop utility version and monitor layout affect reproducibility.
• Separate local and web capture: desktop commands copy pixels already on a display; ScreenshotNeo renders a URL and exposes verdict and billing headers for each response.

FAQ

Can one command work unchanged on Windows, Linux and macOS?

No. The operating systems expose different capture interfaces, and Linux additionally varies by display protocol and desktop environment. Choose a platform-specific utility or place your own abstraction around the appropriate API.

Does ImageMagick’s import capture Wayland?

The documented commands target an X server screen. They should not be described as a general Wayland capture method; verify the session and use a compositor-appropriate tool when X11 access is unavailable.

Is Snipping Tool suitable for a CI job?

The documented protocol launches an interactive capture mode, so it is intended for a user-driven selection rather than a silent, unattended file export. Use application code or a purpose-built capture utility for CI.

Quick Recap

Bestseller No. 1

Guermok Video Capture Card, 4K USB3.0 HDMI to USB C, 1080P 60FPS & 2K 30FPS

$18.99

Bestseller No. 2

Audio Express AXHDCAP 4K HDMI Video Capture Card, Cam Link Card Game Audio Adapter HDMI to USB 2.0 Record Capture Device for Streaming, Live Broadcasting, Video Conference, Teaching, Gaming

$9.98

Bestseller No. 3

Video Capture Card, 4K USB3.0 HDMI to USB C, 1080P60FPS HDMI Capture Card for Streaming, Gaming, Video Recording Compatible with Switch, Xbox, PS4/5, OBS,iPad Mac OS Windows,Camera, Zoom(Silver)

$15.99

Bestseller No. 4

Capture Card, 4K HDMI Video Capture Card, Game Capture Card, 1080P 60FPS Video Capture Device, HDMI to USB 3.0 Capture Card for Streaming, Work with Camera/Xbox/PS4/PS5/PC/OBS

$25.89

Bestseller No. 5

Capture Card, USB Video Capture Card Device, Audio Video Converter Grabber for RCA to USB-Convert VHS Mini DV VCR Hi8 DVD to Digital, for PC TV Tape Player Camcorder, MAC Windows Vista Compatible

$12.99

What should I use when the target is a URL rather than my monitor?

Use a website screenshot API such as ScreenshotNeo. It loads the page itself, can remove consent banners and overlays, and reports whether the response was billable instead of relying on a logged-in desktop session.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.