Mouse JigglerMade for MacApp Store
macOS guides

Resume an Interrupted Download on Mac with curl

Continue a curl download from its saved bytes, keep your Mac awake for that command, and check the finished file before opening it.

A glass document and segmented blue progress bar with one segment bridging a gap, beside a silver laptop.
Editorial illustration
The quick answer

For a download started with curl, rerun it with -C -, the same output file, and the URL for the same file version. The server must support resuming. Keep Safari or Chrome downloads in their own download manager; this is not a way to convert browser partial files.

Check whether curl is the right recovery tool

If Safari or Chrome owns the interrupted download, try its Resume control first. Our browser download guide covers those steps. Do not rename a Safari .download item or a Chrome .crdownload file and assume curl can finish it.

This workflow is for a plain file download you start with curl, using a direct HTTPS link from the publisher. A download page, sign-in form, or streaming video page is not that link. If access depends on your browser login, use the browser or the publisher’s supported download app.

Keep one output filename for one specific version of a file. Resuming uses the length of your partial file; it does not check that the bytes already saved still match the remote version. A link called “latest” can point to different contents tomorrow. If the publisher changed the file, start that version under a new filename.

Choose an empty folder and a clear filename

  1. In Finder, open Downloads and create a new empty folder for this download.
  2. Open Terminal from Applications → Utilities. Type cd followed by a space, drag the new folder from Finder into Terminal, then press Return.
  3. Run pwd to check the folder path. Allow Terminal access to Downloads if macOS asks and you intend to save there.
  4. Copy the direct file link from the publisher. Check that you have enough free space for the completed file.

In the example below, replace the entire URL with your download link and choose an output name that belongs only to this file. archive.zip.part is an ordinary file, with a temporary suffix to remind you it is not verified yet. The example address is a placeholder, not a download service.

Start the download and keep the Mac awake for it

Connect power and keep the MacBook lid open. From your chosen folder, run:

caffeinate -i curl -fL -C - -o "archive.zip.part" 'https://downloads.example.org/archive.zip'

The options have separate jobs:

  • caffeinate -i requests protection from idle system sleep while curl runs. It does not keep the display illuminated.
  • -fL follows redirects and reports HTTP errors rather than saving their error bodies.
  • -C - continues from the size of the local output file; with no existing file, it starts at the beginning.
  • -o names the destination. Leave its path unchanged when resuming.

Keep Terminal open. After a connection failure, restore the connection and run the same command from the same folder. You can also stop an active run with Control-C in that Terminal window, then rerun it later. Do not run two downloads into the same output file at once.

For example, if a 4 GB archive stops after 1 GB, a supported resume requests the remaining bytes. If you changed folders or the output name, curl will not find that partial file and may start over. Check the resume message and the destination before committing to another long transfer.

Unlike a fixed two-hour timer, this awake request ends when the command ends, including when curl exits with an error. It does not reconnect Wi-Fi, renew an expired link, override closing the lid, or disable your screen-lock password. See the caffeinate reference for its other uses.

Use the error to decide what to retry

ResultNext step
curl: (33), cannot resume or byte ranges unsupportedThe server did not accept the resume request. Keep the partial file for now; use the publisher’s supported method or start a fresh download under a new filename.
curl: (22) with 403 or 404Return to the publisher’s page and check access or the link. A replacement link must refer to the exact same file version before you reuse a partial file.
curl: (23), write failureCheck free space, destination permissions, and whether the destination disk is still connected.
The command finishes, but the file opens as a web pageThe link probably returned a page instead of the intended file. An HTTP 200 login page is not caught by -f.

Read the message alongside the number. Resuming is a request to the server, not a guarantee that every hosting service supports it. Do not remove -C - and rerun into the same partial file as a casual troubleshooting step: a fresh transfer can overwrite that file. Use a different output name when intentionally starting over.

Verify the finished file before renaming it

Wait for the command to return without an error. Immediately run echo $?: zero means the command reported success. It does not prove you fetched the intended version or that the saved prefix was correct.

If the publisher provides a SHA-256 checksum for that exact download, run:

shasum -a 256 "archive.zip.part"

Compare the full hexadecimal value with the publisher’s value, not just its first few characters. A mismatch means you should not use the file; check the link and version and download a fresh copy under a new name. Without a trusted expected checksum, computing one only gives you a fingerprint, not proof of correctness.

After verification, rename the file in Finder to remove only .part, leaving its real extension such as .zip or .dmg. Renaming does not repair an incomplete file. Keep macOS’s usual checks when opening downloaded software.

When a menu-bar schedule is useful

The command above already manages its own awake request. For downloads you supervise in a browser instead, Mouse Jiggler for Mac offers recurring hours and a stop time. Review Prevent Sleep While Active and the session conditions before relying on it. The app cannot add resume support to a server or repair an incomplete archive.

For the optional menu-bar controls, download Mouse Jiggler on the Mac App Store and test a short session with your usual lock and battery settings. The curl command above works without the app.

What we tested

On November 14, 2026, we tested the Mac’s built-in curl 8.7.1 on macOS 27.0.1 against a local HTTP test server. An 8 MiB disposable file was interrupted after 1,072,996 bytes. The next request, through a redirect, began at that byte offset; the completed file’s SHA-256 matched the source.

We also observed the idle-sleep assertion while the caffeinate-wrapped download ran. A server that ignored byte ranges produced curl error 33 and left the partial file unchanged. A 404 produced error 22 without appending the error page. These were short local checks, not a public HTTPS download, browser-partial recovery, sleep or locked-screen trial, or a multi-hour transfer. The cover is an editorial illustration.

Check the result before opening the file.

Verify the publisher’s checksum when available. For transfers managed by Safari or Chrome, use their own Resume controls.

Review browser download recovery

View Mouse Jiggler on the Mac App Store · Free to download, with optional PRO features.