Quick guide
The short answer
Sparkle lets an app check for a newer version, download it, and check the update before installing. You usually do not need to install Sparkle yourself. Open the app you want to update and choose Check for Updates. Sparkle updates that app, not every app on your Mac.
How to update an app that uses Sparkle
- Open the app you want to update.
- Look for Check for Updates in the app menu or settings.
- Read the release notes and save your work.
- Follow the update prompt. Reopen the app when the update finishes.
The wording varies by app. Follow the developer's instructions if you cannot find the update command.
If an update does not appear or fails
| What happens | What to check |
|---|---|
| The app says it is up to date | The newer release may need a later macOS version, be a beta, or be rolling out gradually. |
| The download fails | Check your connection and the developer's service status. Try again later if the service is down. |
| A signature check fails | Keep the working app and contact the developer. Do not disable the safety check. |
| The app cannot be replaced | Quit it and follow the installer instructions. Ask the developer about permissions if needed. |
Keep the exact error message when asking for help. It is more useful than saying only that the update did not work.
What Sparkle checks
The developer publishes an update list called an appcast. Sparkle reads it to find the version, download address, and macOS requirements.
Sparkle checks the update's digital signature. This helps show that the downloaded file matches what the developer signed, rather than a changed copy.
That does not prove the update is bug-free or right for your work. Read the release notes before a major upgrade. A stolen signing key can also undermine these checks.
Is Sparkle the same as a Mac app updater?
No. Sparkle is part of an individual app. A separate Mac app updater checks a list of apps from several places, including the App Store and Homebrew.
You can use both. Your app keeps its own update system. macCurrent finds updates across several sources and can install supported updates.
How macCurrent helps with Sparkle apps
macCurrent can find updates from Sparkle feeds and show them alongside updates from other sources. It shows the installed version, the newer version, and the next action.
For supported direct updates, macCurrent checks the download, can save the old app, and installs the new version. Some apps still need their own updater. See how update checks work or the Mac app updater guide.
Want the technical details?
Feeds, signatures, and Sparkle versions
Some apps store their feed address in an SUFeedURL setting. This Terminal command reads it; replace App.app with the actual app name:
defaults read /Applications/App.app/Contents/Info.plist SUFeedURLA printed address is a clue, not proof that the app uses it now. A missing setting does not rule Sparkle out: the developer can set the address in code.
Sparkle 2 supports a separate installation service and sandboxed apps. EdDSA signatures also appeared in later Sparkle 1 releases. The signature type alone does not identify the Sparkle version.
Signatures help check the downloaded file. They do not replace checks of the app's identity, version, or compatibility. Prefer the app's documented update path and do not ignore security warnings.
Developers can read the official Sparkle documentation, update options, and signature migration guide.
Frequently asked questions
Do I need to install Sparkle?
Usually not. The app developer includes it. Use the app's Check for Updates command.
What is an appcast?
It is the developer's list of app releases. Sparkle reads that list to find newer versions and their download details.
Can Sparkle update every app on my Mac?
No. It updates the app that includes it. Other apps use their own updater, Homebrew, or the App Store.
Are Sparkle updates always safe?
No check guarantees that a release is bug-free. Use the app's documented updater, do not ignore signature warnings, and read the notes before a major upgrade.
Does macCurrent replace Sparkle?
No. The app keeps its own updater. macCurrent can find and install supported updates, including eligible direct replacements. Some apps still need their own updater.