Get a notification once your iTunes Connect build is finished processing
Switch branches/tags
Nothing to show
Clone or download
Latest commit 63bf791 Apr 12, 2018




Twitter: @FastlaneTools License Gem

Get a notification once your iTunes Connect build is finished processing

When you upload a new binary from Xcode to iTunes Connect, you have to wait until it's done processing before you can submit it to the App Store.

As the #iosprocessingtime varies from a few minutes to multiple hours, it's easy to forget to check iTunes Connect to see if the build is ready. WatchBuild lets you know as soon as it is done.

WatchBuild is a simple standalone tool that shows a notification once your newly uploaded build was successfully processed by iTunes Connect.

Once the build is ready to be pushed to TestFlight or for review, you get a macOS notification. You can even directly click on the notification to open the build on iTunes Connect.

Why use WatchBuild?

WatchBuild is a standalone tool and can be used without any of the other fastlane tools. This is big, since you can use WatchBuild also if you use Xcode to upload your app.

This tool is not a replacement for deliver (Upload metadata and builds to iTunes Connect) or pilot (Upload and distribute new builds to TestFlight), but is meant as a small helpful utility with the main purpose to wait for the binary processing to be finished.

Get in contact with the developer on Twitter: @FastlaneTools

InstallationUsageTipsNeed help?


sudo gem install watchbuild

Make sure, you have the latest version of the Xcode command line tools installed:

xcode-select --install



You can pass your bundle identifier and username like this:

watchbuild -a -u

For a list of available parameters and commands run

watchbuild --help

How is my password stored?

WatchBuild uses the secure CredentialsManager from fastlane that stores credentials in your local keychain.


fastlane Toolchain

  • fastlane: The easiest way to automate beta deployments and releases for your iOS and Android apps
  • deliver: Upload screenshots, metadata and your app to the App Store
  • snapshot: Automate taking localized screenshots of your iOS app on every device
  • frameit: Quickly put your screenshots into the right device frames
  • pem: Automatically generate and renew your push notification profiles
  • sigh: Because you would rather spend your time building stuff than fighting provisioning
  • produce: Create new iOS apps on iTunes Connect and Dev Portal using the command line
  • cert: Automatically create and maintain iOS code signing certificates
  • spaceship: Ruby library to access the Apple Dev Center and iTunes Connect
  • pilot: The best way to manage your TestFlight testers and builds from your terminal
  • boarding: The easiest way to invite your TestFlight beta testers
  • gym: Building your iOS apps has never been easier
  • scan: The easiest way to run tests of your iOS and Mac app
  • match: Easily sync your certificates and profiles across your team using git
Like this tool? Be the first to know about updates and new fastlane tools

Need help?

Please submit an issue on GitHub and provide information about your setup

Code of Conduct

Help us keep watchbuild open and inclusive. Please read and follow our Code of Conduct.


This project is licensed under the terms of the MIT license. See the LICENSE file.

This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.