Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

How to Take Screenshots with Headless Chrome in WSL Ubuntu

Use Chrome’s headless screenshot flag in WSL Ubuntu, then find the PNG in Linux or Windows. Includes viewport, timeout, filesystem, and troubleshooting guidance.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

In WSL Ubuntu, run Chrome with --headless --screenshot to save a PNG without opening a visible browser window. The file is written as screenshot.png in the shell’s current working directory. Add --window-size=WIDTH,HEIGHT to set the viewport.

Take a screenshot from WSL Ubuntu

First make a Chrome-compatible browser binary available in your Ubuntu distribution. The command below assumes it is named google-chrome; package names and executable names differ, so check yours before running it. This guide does not prescribe an installation command.

As an Amazon Associate I earn from qualifying purchases.

  1. Check for a browser executable:

    command -v google-chrome
    command -v chromium

    Use whichever command is installed. Chrome’s generic command-line examples use chrome; some Linux installations instead expose google-chrome or chromium.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  2. Choose where the screenshot should go. For a Linux-side directory:

    #1 Best Overall
    Sale
    BenQ GW2790C 27" IPS Computer Montior 1080P FHD 144Hz Game-Ready, Home Office, USB-C, Visual Optimizer, Flicker-Free, Low Blue Light, Ultra Slim Bezel, TUV-Certified, Eye-CareU
    • 【Designed for Comfortable All-Day Productivity】 Enhance your workflow with a 24-inch IPS eye care monitor built for home office, study, and daily tasks, featuring BenQ Eye-Care technologies to reduce eye strain during extended screen time.
    • 【USB-C One-Cable Convenience】 Connect your laptop or MacBook with a single USB-C cable for video, data, and power delivery, reducing cable clutter and simplifying your workspace
    • 【Smooth 144Hz for Better Work Experience】 Enjoy smoother scrolling, reduced motion blur, and more responsive multitasking compared to standard 60Hz monitors—perfect for long work sessions and Gaming!
    • 【Built for Business & Office Deployment】 Designed for corporate offices, remote teams, and large-scale workstation setups. Reliable performance and consistent display quality make it ideal for IT deployment and bulk purchasing
    • 【Energy Efficient & Certified Sustainability】 Reduce energy consumption and lower operating costs—an efficient choice for businesses and users running monitors for extended hours
    mkdir -p ~/screenshots
    cd ~/screenshots
    pwd

    The pwd output is the directory where Chrome will save the default screenshot.

  3. Run the capture, replacing the binary name, URL, and dimensions as needed:

    google-chrome --headless --screenshot --window-size=1280,900 https://example.com

    If your installed browser is named chromium, for example, substitute that name. The command asks for a 1280-by-900 viewport; it does not promise that every page will finish loading all content or animations in that time.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  4. Confirm the output:

    ls -l screenshot.png

    Chrome’s documented default is screenshot.png in the current working directory. See the Chrome Headless command-line reference for current CLI behavior.

Choose the screenshot size and timing

Set the viewport

Use --window-size=WIDTH,HEIGHT alongside --screenshot, with width and height in pixels, such as --window-size=1280,900. The viewport affects responsive page layout, so a different size can change which navigation, columns, or controls appear.

Allow more time for loading

--timeout=MILLISECONDS sets a maximum wait before capture even if the page is still loading. A larger value can give slow pages more time, but it is not a readiness guarantee: network-dependent content, animations, or scripts may still be unfinished when the screenshot is taken.

Rank #2
Sale
MNN 15.6" FHD 60Hz Portable Monitor USB-C HDMI IPS HDR Gaming Laptop
  • Full HD Portable Monitor - MNN 15.6inch portable laptop monitor with 1920*1080 resolution, advanced IPS glossy screen support 178° full viewing angle, it renders accurate and bright color, draws you into the video or game with lifelike colors and amazing detail.It can effectively reduce blue light radiation damage, no flickering, eye-care, and make it easier to watch for a long time.A second monitor for working from home.
  • Double Type-C Port -For Plug & Play, the MNN monitor provides 2 Full Feature Type-C ports. Only One USB Type-C Cable is required to connect to the power supply & display signal transmission. NOTE: Your device should support thunderbolt 3.0 or USB 3.1 Type C DP ALT-MODE.which supports multiple connect ways to your laptops, PC, Phones, Macbooks, PS5/PS4, Xbox, and Switch.
  • Lightweight Ultra Slim for Travel - As a portable external monitor,MNN portable laptop monitor easily accommodate to every suitcase and backpack and stress-free when you are holding it for a long time. They are truly portable computer monitors for travelers, students, gamers,engineers, and everyone.
  • Give consideration to work and games - through multiple display modes [Copy Mode/Extended Mode/Second Screen Mode/Portrait Mode], we can bring you a clear second screen in the meeting, and expand the screen anytime and anywhere to improve work efficiency and improve the quality of life. Adjusting to HDR mode can upgrade the image to a new level, providing you with brighter highlights,deeper and more realistic colors, more realistic images, and amazing viewing/gaming experience.
  • Powerful Smart Cover - MNN portable external monitor can work in both landscape and portrait mode, can be used as a gaming monitor, screen extender for laptop or phone. Comes with a scratch-proof smart cover made of durable PU leather exterior, doubles as a stand, provides comprehensive protection for this portable computer monitor.

--virtual-time-budget=MILLISECONDS can fast-forward time-dependent page code, including timer-based updates. It is not a universal replacement for waiting for network requests or a site-specific ready condition. Consult the Chrome CLI reference for option details.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Find the file from Windows

Open the current Linux directory

From the WSL shell in the directory containing the image, run:

explorer.exe .

File Explorer opens that directory. You can also browse the distribution from a Windows path such as \wsl.localhostUbuntuhomeusernamescreenshots, substituting your actual distribution name and Linux username. Depending on Windows and WSL version, the share may also be exposed through \wsl$. Microsoft documents both approaches in its WSL file system guidance.

Save directly to a Windows drive

Windows drives are mounted under /mnt/ by default. If your automount configuration is unchanged, choose a Windows directory before capturing:

cd /mnt/c/Users/WindowsUser/Pictures
google-chrome --headless --screenshot --window-size=1280,900 https://example.com

Replace WindowsUser with the actual Windows account name. Chrome writes screenshot.png into that directory, making it available to Windows applications. Mount configuration can differ.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Pick storage for the tools that will use the file

For Linux development tools, keep working files in the WSL Linux filesystem; for Windows tools, a Windows-mounted directory may be more convenient. Microsoft’s guidance is to store project files on the same operating system as the tools that use them. That is a workflow recommendation, not a requirement that screenshots always live in one filesystem. See Microsoft’s WSL filesystem guidance.

Rank #3
ViewSonic VA2448-MHU 24 Inch 1080p IPS Computer Monitor, 120Hz, USB C
  • VERSATILE FULL HD IPS DISPLAY: This 24 inch computer monitor combines 1080p resolution, a 120Hz refresh rate, 1ms response time, and 300-nit brightness for fluid everyday work, streaming, study, and home office use.
  • USB C CONNECTIVITY: USB C, HDMI, and VGA give this 24 inch monitor flexible connections for compatible laptops, PCs, and Macs while helping simplify a modern home office, school, business, or study setup.
  • VARIABLE REFRESH RATE: Adaptive display technology helps this 120Hz monitor reduce tearing and provide smoother movement during scrolling, video playback, multimedia, and compatible casual gaming.
  • FRAMELESS DESIGN AND EYE CARE: Thin bezels and Eye Care features make this desktop monitor practical for single- or multi-display workspaces and more comfortable for extended productivity, research, and viewing sessions.
  • BUILT-IN AUDIO: Dual speakers add convenient sound to this PC monitor, supporting meetings, videos, training, and multimedia without separate desktop speakers while remaining compatible with laptop, PC, and Mac systems.

What the basic screenshot flag does not guarantee

The documented --screenshot command captures the target page to a PNG; the current CLI reference does not establish that this flag alone captures an arbitrarily tall full page. For full-page screenshots, use browser automation with an explicit full-page capture option, such as Puppeteer’s screenshot options.

Current Chrome Headless mode runs Chrome without a visible UI, and Chrome says this updated mode has been available since Chrome 112. The separate old Headless shell documentation is marked deprecated, so it is not the default starting point for a new workflow. The ordinary command shown here does not require adding --disable-gpu.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot common problems

Or skip the browser setup

For a one-request capture through a screenshot API, ScreenshotNeo accepts a URL and returns an image or PDF. This cURL example saves the response as a WebP image; replace the URL and supply your API key:

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

See the ScreenshotNeo API documentation for request options. ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are not billed. It also provides an MCP server for AI agents, and includes 1,000 screenshots per month on the free plan without a card; paid plans start at $5 for 3,000 screenshots. Learn more at ScreenshotNeo.

Sign up for 1,000 free screenshots a month, with no card required.

Frequently Asked Questions

Does the basic Headless Chrome command save a PDF?

No. The command in this guide uses --screenshot to create a PNG. PDF output requires a different capture workflow.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Can I choose a different screenshot filename with this command?

The documented default is screenshot.png. Whether an explicit output path or filename is supported depends on the installed Chrome version; consult its current CLI reference.

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.