Canopy brings real‐time notifications to GitHub. Respond to people promptly; have real‐time conversations on pull‐requests and issues; get the job done faster and more efficiently; and—most importantly—stay on top of development.
Tapping Canopy’s notifications opens the relevant GitHub page in your web-browser; no more hunting through emails for the link.
Canopy is free for open source (public repositories) with a subscription for private repositories.
I don’t get notifications when my Mac is off
Push notifications will only deliver to devices that are on.
I don’t get any notifications
Ensure you have enabled some, in the app select repositories for which you want to receive notifications and tap the checkbox.
If you still don’t receive notifications visit that repository on GitHub and ensure the Canopy webhook is enabled, Canopy does this for you, but it may have been disabled by another user or tool.
If you still don’t get notifications, rebooting your Mac will restart the APNs service, which may help.
Clicking notifications doesn’t open the GitHub page
Clicking notifications doesn’t seem to work on Mojave at this time.
Clicking notifications opens Canopy first, why not just open the web-page directly?
This is technically tricky to fix, but we’re working on it
I can’t enable notifications
First install the webhook, then tap the “Notify” checkbox.
You cannot install webhooks unless you are admin for the repository, contact the admin! You can still enroll for notifications in advance, when the admin creates the hook you will receive a notification about it.
You cannot get notifications for private repositories unless you create a Canopy subscription.
Do I need to leave the app open?
No, your push notifications will arrive even if the app is shut.
I cannot see a particular private repo.
The GitHub API does not return results for private repositories that are forked from private repositories (for OAuth apps like Canopy).
We plan to fix this by updating our backend to be a proper GitHub app.
In the meantime you can add repositories that are not visible in the Canopy app manually via the “File” menu.
I do not get certain notifications I was expecting
Canopy can only report activity that is supported by GitHub’s webhook system, notably this does not include:
† Unless the repository owner installs the Canopy webhook *and* you manually add that repository to Canopy.
Can I get notifications for repositories unrelated to my account?
Yes, if they are open source and if they have the Canopy webhook installed, if they don’t have the hook installed you can ask them to install it (see the above FAQ), really, there’s no reason they shouldn’t.
If the above conditions are met you can enroll in notifications manually using the ”Add Repository” entry in the “File” menu.
Can I install the Canopy webhook without the app?
Yes, just add
https://canopy.codebasesaga.com/github to any
repository’s webhooks (ensure its content‐type is
If you do this other people can receive notifications.
Note if you do it this way we cannot install a “secret” which means we cannot be fully sure that the payloads we receive are from GitHub and not someone pretending to be GitHub. If this worries you, install the hook using the app.
Why does Canopy ask for full access to my repositories?
GitHub does not provide sufficient granularity in its permissions system, thus in order to receive events for your private repositories we have to ask for full-access permissions.
Needless to say Canopy does not write to your repos
How does Canopy ensure that only people with access get notifications about my private repositories?
Our backend does a HEAD request on behalf of all users before pushing notifications for private repositories, if they have no access GitHub gives us a 404 and we delete their enrollment for that repository.
This means we will stop sending notifications for team members you remove from a repository the moment you do so.
Will my subscription in the macOS app work with the iOS app?
Yes, the subscription in either will work in the other
Why do you send me notifications for my own activity!
This will be optional in the next release.
How about GitHub Enterprise?
Feature coming soon!
Our company requires that we run the server‐side component
We are happy to provide the server-side binary, compiled for your platform, so that your data never leaves your control if you are serious in your needs contact us for terms.
How about Android, Linux and Windows?
If Canopy is successful (and not Sherlocked) we will make apps for the other platforms
How can I stay updated?
The App Store updates your apps automatically, but if you want informational updates: follow @mxcl on Twitter.
I have a suggestion
Ask @mxcl about it.
Canopy listens to GitHub events and passes a small subset of this data through to Apple’s APNs service.
Canopy does not read your code, nor does it persist any data about your notifications, your activity or your code. Canopy does not submit any of your data that it persists to third parties.
Your data is held securely and cannot be accessed by third‐parties.
† we are encrypting your token, not your password, we never have access to your password.
GitHub sends Canopy webhooks for repository events, Canopy must know for which repositories you wish to receive notifications and which devices you wish these notifications sent. Your GitHub OAuth token is required so Canopy can check you still have access to private repositories, and so Canopy’s backend can install webhooks at GitHub.
Email us and we can completely delete your account.
Email us and we’ll get right back to you.
Your access to and use of Canopy is conditioned on your acceptance of and compliance with the following terms. By using Canopy you agree to be bound by these terms. If you disagree with any part of the terms then you may not use Canopy.
Use of Canopy requires signing‐in with a valid GitHub account. Use of GitHub is bound by the GitHub terms of service.
You agree to not attempt access via Canopy to content to which you knowingly have no right.
Codebase LLC reserves the right, at its sole discretion to change, limit, or discontinue any aspect, content, or feature of Canopy, as well as any aspect pertainning to the use of Canopy.
You retain all rights to your content and we retain all rights to ours (for example the Canopy icon, website, design language, source code, trademarks, copyrights, patents and other intellectual property).
Codebase LLC reserve the right to end your access to Canopy at any time and for any reason. If your use is ended, any pending subscription periods will be refunded.
Canopy may contain links to third‐party services that are not owned or controlled by Codebase LLC. Codebase LLC has no control over, and assumes no responsibility for, the content, privacy policies, or practices of any third‐party service. You further acknowledge and agree that Codebase LLC shall not be responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods or services available on or through any such web sites or services.
We reserve the right, at our sole discretion, to modify or replace these terms at any time.