Skip to content
Automatically update open source macOS apps from GitHub releases.
Branch: master
Clone or download
Latest commit ba66611 Feb 28, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore .gitignore Feb 17, 2019
.travis.yml [ci] warnings-as-errors Feb 18, 2019
Package.swift Fix hardcoded executable path; Fixes #1 Feb 17, 2019


A simple app-updater for macOS, checks your GitHub releases for a binary asset once a day and silently updates your app.


  • We make no allowances for ensuring your app is not being actively used by the user at the time of update. PR welcome.
  • Assets must be named: \(reponame)-\(semanticVersion).ext.
  • Will not work if App is installed as a root user.


  • Full semantic versioning support: we understand alpha/beta etc.
  • We check the code-sign identity of the download matches the app that is running before doing the update. Thus if you don’t code-sign I’m not sure what would happen.
  • We support zip files or tarballs.

Support mxcl

Hey there, I’m Max Howell. I’m a prolific producer of open source software and probably you already use some of it (for example, I created brew). I work full-time on open source and it’s hard; currently I earn less than minimum wage. Please help me continue my work, I appreciate it 🙏🏻

Other ways to say thanks.


package.dependencies.append(.package(url: "", from: "1.0.0"))


import AppUpdater

class AppDelegate: NSObject, NSApplicationDelegate {
    let updater = AppUpdater(owner: "your-github-username", repo: "your-github-repo-name")

    //NOTE this is optional, the `AppUpdater` object schedules a daily update check itself    
    @IBAction func userRequestedAnExplicitUpdateCheck() {
        updater.check().catch(policy: .allErrors) { error in
            if error.isCancelled {
                // promise is cancelled if we are already up-to-date
            } else {
                // show alert for this error


You can’t perform that action at this time.