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

Use SingleFile CLI to save a webpage as one self-contained HTML file: install the CLI, make sure a supported browser is available, then run single-file <URL> <output-file>. For example, single-file https://www.wikipedia.org wikipedia.html saves the page to wikipedia.html. The tool runs the capture in a headless browser; this guide covers setup, sign-in, batches, crawling, and common failures.

Install SingleFile CLI

SingleFile CLI is the command-line capture tool in the SingleFile project. Its official README documents several installation routes; choose one that suits how you manage software. The commands and setup details below come from the official SingleFile CLI repository. The project instructions are rolling, so check the repository and your installed version’s help for current compatibility details.

  • Download an executable: use the downloadable executable documented by the project.
  • Use npm/npx: install with npm install "single-file-cli", then invoke the CLI with npx single-file.
  • Use Docker: the project documents a Docker route for running the CLI.
  • Install manually: manual installation from an archive or Git checkout requires Deno.

Follow the repository’s installation instructions for the route you choose. The CLI captures pages through a browser, so completing the CLI installation alone may not be enough.

Check the browser setup

SingleFile CLI uses a headless browser to load and capture the page. The project expects Chrome or a Chromium-based browser in its default folder. If your browser executable is elsewhere, specify its location with --browser-executable-path.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

Chrome/Chromium is the default browser engine. Firefox can be selected with --browser-engine firefox; consult the installed CLI’s help for Firefox limitations. The project describes using Chrome DevTools Protocol for Chrome and WebDriver BiDi for Firefox.

Save one webpage as an HTML file

  1. Choose a page URL that you can access from the browser environment running the command.
  2. Choose an output path for the saved HTML file.
  3. Run the command:
    single-file https://www.wikipedia.org wikipedia.html
  4. Check the result at the named output path. Replace the example URL and filename with your target and preferred destination.

The basic form is single-file <url> [output] [options ...]. The output argument is optional. To write the captured HTML to standard output instead of naming a file, use:

single-file https://www.wikipedia.org --dump-content

SingleFile’s parent project describes its aim as saving a complete webpage into a single HTML file. That does not guarantee every site or interactive feature will be reproduced perfectly: results depend on the page, its loading behavior, access requirements, and browser setup.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

Save a page that requires sign-in

For a page that requires authentication, the documented workflow is to create a browser profile, sign in interactively, and then reuse that profile for capture.

  1. Create the profile and open the sign-in page:
    single-file --create-browser-profile ./profiles/example https://www.example.com/login
  2. Sign in in the browser window that opens, then exit the browser so the profile is saved.
  3. Capture the protected page using that profile:
    single-file https://www.example.com/account account.html --browser-profile=./profiles/example

The project says the profile is copied and left unmodified during reuse. Keep the profile directory available to the process and protect it as you would other browser data that may contain authenticated session information.

Capture a list of URLs or crawl links

Process a URL list

Put one URL per entry in a file such as list-urls.txt, then pass it to the CLI:

single-file --urls-file=list-urls.txt

Use the installed version’s help for any additional output or batch options you need.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

Crawl internal links to a limited depth

The repository gives this example for crawling internal links to depth 1:

single-file https://www.example.com --crawl-links=true --crawl-inner-links-only=true --crawl-max-depth=1

A one-page capture does not archive a whole site. Crawling is a separate, configurable operation: the CLI also documents rewrite rules, external-link crawling, and an archive option that marks links that were not archived. Review the CLI help before using those options so the crawl scope matches your intent.

Choose the right capture route

Need Use What to expect
Save one accessible page URL plus output filename Captures a single page as an HTML file.
Save the HTML to a pipeline or terminal output --dump-content Writes captured HTML to standard output.
Capture pages behind sign-in Create and reuse a browser profile Complete sign-in interactively before the capture.
Capture a known set of pages --urls-file Processes the URLs in a list file.
Follow links from a page Crawl options Configure depth and whether crawling is limited to internal links.

Understand exit codes and failed captures

The CLI documents these exit codes:

  • 0: all pages were saved.
  • 1: at least one capture failed, while other pages in a batch or crawl were still saved.
  • 255: an error prevented the process from running.

For a batch that exits with 1, check the individual outputs rather than treating the whole run as a total failure. For 255, first check whether the command can start and whether its browser setup and options are valid.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot common problems

The command cannot find or start a browser

Confirm that Chrome or a Chromium-based browser is installed in the expected default folder. If it is installed elsewhere, set --browser-executable-path to its executable. If using Firefox, explicitly select it with --browser-engine firefox and check the CLI help for limitations.

A protected page saves as a login screen or access-denied page

Use the browser-profile workflow: create a profile with the login URL, complete sign-in in the opened browser, exit to save, then pass the profile with --browser-profile=./profiles/example. A command run without the authenticated profile does not inherit your normal browser’s signed-in session.

Some pages in a batch are missing

Check the exit code and inspect which outputs were created. Exit code 1 means some pages failed but other pages were saved. Verify that each URL is reachable in the browser environment and that the URL-list file contains the intended entries.

The capture does not include expected content or behavior

SingleFile captures a page through a browser; a site’s dynamic content, access controls, or loading behavior can affect what is present at capture time. The project does not guarantee perfect reproduction for every website. Check the target page in the same browser environment and consult single-file --help for the installed version’s available options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

The options do not match examples

Run single-file --help. The official README is rolling documentation, and available options or compatibility details should be verified against the version you installed.

Or skip the browser setup

If you need a rendered screenshot or PDF rather than a self-contained HTML archive, ScreenshotNeo can capture a URL through one GET request. See the ScreenshotNeo API documentation for options.

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

ScreenshotNeo accepts cookie and consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each of those steps can be turned off. Bot checks/CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and the response identifies the page verdict and billing status in headers. It also offers an MCP server for AI agents, including Claude, Cursor, and other MCP clients. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots.

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

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

License note

The SingleFile CLI repository identifies its license as AGPL and directs commercial-service or product licensing inquiries to the maintainer. For a particular use, consult the license text and seek appropriate legal advice rather than inferring a legal conclusion from that summary.

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.