Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.
To capture more than the primary display with Java’s Robot, calculate the virtual desktop bounds by unioning the bounds of every screen’s GraphicsConfiguration, then pass that rectangle to createScreenCapture. This also includes monitors positioned left or above the primary display, where screen coordinates can be negative.
Capture the whole virtual desktop
Robot captures the screen rectangle you give it; constructing a default Robot does not by itself mean “capture every monitor.” Build the rectangle from the actual graphics configurations instead of assuming the desktop starts at (0, 0). Oracle documents this union-of-bounds approach as the way to determine the virtual device bounds.
The following complete example checks for a headless environment, unions all configuration bounds, captures that rectangle, and writes a PNG. Pass an output path as the first command-line argument, or it writes desktop.png in the current working directory.
import java.awt.AWTException;
import java.awt.GraphicsConfiguration;
import java.awt.GraphicsDevice;
import java.awt.GraphicsEnvironment;
import java.awt.Rectangle;
import java.awt.Robot;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import javax.imageio.ImageIO;
public class CaptureDesktop {
public static void main(String[] args) throws IOException, AWTException {
GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
if (ge.isHeadless()) {
throw new IllegalStateException("Screen capture requires a graphical desktop");
}
Rectangle virtualBounds = new Rectangle();
for (GraphicsDevice device : ge.getScreenDevices()) {
for (GraphicsConfiguration config : device.getConfigurations()) {
virtualBounds = virtualBounds.union(config.getBounds());
}
}
if (virtualBounds.width <= 0 || virtualBounds.height <= 0) {
throw new IllegalStateException("No usable screen bounds were found");
}
Robot robot = new Robot();
BufferedImage image = robot.createScreenCapture(virtualBounds);
File output = new File(args.length > 0 ? args[0] : "desktop.png");
if (!ImageIO.write(image, "png", output)) {
throw new IOException("No PNG writer is available");
}
System.out.printf("Saved %s (%d x %d)%n", output.getAbsolutePath(),
image.getWidth(), image.getHeight());
}
}Compile and run it in a graphical desktop session:
javac CaptureDesktop.java
java CaptureDesktop desktop.pngThe output image is the rectangular union, not a collage. If monitors are arranged with gaps or nonrectangular geometry, those gaps remain part of the bounding rectangle. The capture API operates on screen coordinates, so monitor positions and the rectangle dimensions determine what is requested.
#1 Best Overall
- 【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
Why a monitor beyond the primary screen gets missed
A monitor to the left of the primary display may have a negative X coordinate; one above it may have a negative Y coordinate. A rectangle fixed at (0, 0) cannot represent those areas. The union operation preserves the minimum and maximum extents across configurations, producing the rectangle needed for the complete desktop.
Do not assume all platforms arrange displays in the same coordinate model. Oracle notes that screens may share a coordinate system to form a combined virtual screen, or use separate coordinate systems as independent screens. Inspect GraphicsConfiguration.getBounds() at runtime on the target system.
Capture one particular display
When the task is limited to one monitor, select its GraphicsDevice, use the matching bounds, and construct a device-specific Robot. This avoids capturing the other displays.
Rank #2
- [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.
GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
GraphicsDevice device = ge.getScreenDevices()[0]; // choose the desired device
GraphicsConfiguration config = device.getDefaultConfiguration();
Rectangle bounds = config.getBounds();
Robot robot = new Robot(device);
BufferedImage image = robot.createScreenCapture(bounds);
ImageIO.write(image, "png", new File("monitor.png"));The array index is only an example: do not assume device zero is the display you want. Enumerate devices and print each device’s ID string and configuration bounds, then select according to the environment or user choice. If a device has multiple configurations, inspect them and use the configuration whose bounds describe the target area.
Handle HiDPI scaling and native-resolution output
On scaled displays, logical user-space dimensions and native device-pixel dimensions may differ. Java provides createMultiResolutionScreenCapture(Rectangle) for this case. It returns a MultiResolutionImage with a base user-size image and, where available, a device-resolution variant. Select the native-size variant when retaining device-pixel detail matters.
import java.awt.Image;
import java.awt.image.MultiResolutionImage;
MultiResolutionImage capture = robot.createMultiResolutionScreenCapture(bounds);
for (Image variant : capture.getResolutionVariants()) {
System.out.printf("Variant: %d x %d%n", variant.getWidth(null), variant.getHeight(null));
}
Image nativeOrLargest = capture.getResolutionVariants().stream()
.max(java.util.Comparator.comparingLong(
image -> (long) image.getWidth(null) * image.getHeight(null)))
.orElseThrow();The largest returned variant is a practical selection when the goal is maximum available pixel detail, but inspect the variants rather than assuming a particular count or scale factor. An ordinary non-scaled display may yield only one variant. Convert the chosen Image to a BufferedImage if you need to save it through ImageIO.
Rank #3
- 【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.
Coordinate, permission, and threading limits
- Headless execution:
Robot()andRobot(GraphicsDevice)throwAWTExceptionif the graphics environment is headless or the platform cannot provide low-level input control. A server process without a graphical desktop cannot capture a desktop that does not exist. - Screen-reading permission:
createScreenCapturemay throwSecurityExceptionif permission is denied. Some modern desktop environments require explicit screen-recording approval; grant it to the Java runtime or application and restart if the environment requires that. - Cursor: Robot’s screen-capture image does not include the mouse pointer, as Oracle’s API documentation specifies. If the cursor must appear, this API alone does not satisfy that requirement.
- Event dispatch thread: Avoid lengthy capture, image conversion, or file writing on Swing’s AWT event-dispatch thread. Run work in a background task so the UI remains responsive.
- Invalid geometry: A zero or negative width or height is not a valid capture rectangle. Validate the computed bounds and handle
IllegalArgumentException.
Troubleshooting common failures
| Symptom or exception | Likely cause | What to check or change |
|---|---|---|
| Only the primary screen appears | The capture rectangle was hard-coded from (0, 0) or sized for one display. |
Enumerate every device configuration and union all bounds. Print the rectangle’s x, y, width, and height before capture. |
| Left or upper monitor is clipped | The code discarded negative screen coordinates. | Use the full union rectangle, including its negative x or y origin; do not reset the origin to zero. |
AWTException during Robot construction |
The environment is headless or does not support the required low-level desktop control. | Check GraphicsEnvironment.isHeadless() and run the program inside a supported graphical desktop session. |
SecurityException while capturing |
Desktop screen-reading permission is denied. | Review the operating system’s screen-recording/privacy permission for the Java runtime or application. |
IllegalArgumentException for the rectangle |
The rectangle has zero or negative dimensions or otherwise invalid geometry. | Verify that devices/configurations were found and that the union has positive width and height. |
| Image lacks expected detail on a scaled display | The selected image is the user-size variant rather than a native-resolution variant. | Use createMultiResolutionScreenCapture, inspect getResolutionVariants(), and select the desired resolution. |
| No mouse pointer in PNG | Robot capture excludes the cursor. | Do not treat this as a failed capture; use a different capture approach if cursor inclusion is essential. |
| Output file absent or not PNG | Write failed, the path is unexpected, or no writer accepted the format. | Use an explicit output path, check write permissions, and test the boolean result from ImageIO.write. |
Reliability and practical deployment
Screen capture is a snapshot of a live desktop, not a reliable substitute for rendering a web page on a server. The machine must have an active graphical environment, usable screen bounds, and any required user-granted permissions. For scheduled or automated desktop jobs, log the detected device bounds and the final captured image dimensions; that makes layout changes and empty captures easier to diagnose.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →For a multi-monitor desktop, the resulting image can be large because it spans the entire union rectangle, including any empty space between displays. If the task only needs one window or one display, capture the smallest relevant rectangle to reduce memory use and output size. Do not perform capture and file I/O on a UI thread.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Or skip the browser setup
If what you need is a screenshot of a website rather than the physical desktop, ScreenshotNeo is a website screenshot API and MCP server for developers. A single GET request takes a URL and returns a PNG, JPEG, WebP, or PDF. It is not a replacement for capturing arbitrary desktop applications: it captures web pages.
Rank #4
- 【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.
For example, the cURL request below saves a WebP screenshot of Stripe. Replace the URL with the page you need and use your API key. See the ScreenshotNeo API documentation for request options and response details.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpScreenshotNeo accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each cleanup step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, with response headers indicating the page verdict and whether the request was billed. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients.
Recommended Free Tools
The free plan includes 1,000 screenshots per month with no card required; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo’s free plan.
Frequently Asked Questions
Does Java Robot capture the mouse cursor?
No. The image returned by Robot’s screen-capture API excludes the cursor.
Best Value
- 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
Can Robot take screenshots on a headless server?
Not of a desktop that is not available: Robot construction can fail with AWTException in a headless environment.
Does ScreenshotNeo capture a whole computer display?
No. ScreenshotNeo captures website pages; it is not a physical desktop or arbitrary application capture tool.
Free tools Windows power users keep installed
One-click scans. No signup required.
Quick Recap
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.
