Advanced GitHub Notifier v1.10.2
Conveniently get notified when you get a new notification on GitHub.com or a GitHub Enterprise instance with this extension. If you missed a notification, you can easily access the subject of the notification directly from a popup listing all unread notifications.
The button to open the panel shows a count of unread notifications. You can mark all notifications as read from within the panel or open GitHub's notification page.
You can authenticate as multiple GitHub.com and GitHub Enterprise users at once.
GitHub Authentification
In order to get your notifications you have to authenticate the extension to access your GitHub notifications. The authentication is handled completely client-side and there is no third party server involved in it. The repo read and write permission is needed to display notifications for private repositories. This permission only has to be granted on organizations with private repositories that you need notifications for. In theory the extension only needs read access to determine issue title and similar. However GitHub only has a scope for read and write access.
You can also authenticate with a personal access token for GitHub.com. For enterprise installations you can always try to use OAuth, but no guarantees, while personal access tokens should work as well. The personal access tokens need at least the notifications permission, and if the notifications should be accurate for things in private repos, it also needs the repo permission.
GitLab and Gitea
GitLab and Gitea support is fairly simple. For GitLab todos are shown as notifications, for Gitea it's notifications. Both of them require you to provide an access token as well as the base URL of the instance. The appearance will be identical to notifications from GitHub.
Languages
This extension is translated to Dutch, German, Italian, Russian, Spanish, Thai, French, Chinese (China and Taiwan), Japanese.
You can help translate this extension on Transifex: https://www.transifex.com/freaktechnik/advanced-github-notifier/
Permissions
- identity: OAuth flow API
- Display notifications to you: To show notifications when a new notification is added on GitHub
- alarms: Periodically check for new notifications.
- storage: Save settings and notifications
- Access your data for "https://github.com/login/oauth/access_token": To complete OAuth with GitHub even when CORS headers are missing
Additionally the extension may prompt to access specific hosts for authenticating and interacting with them if you configure a GitHub Enterprise or Gitea account.
See https://support.mozilla.org/kb/permission-request-messages-firefox-extensions for explanations what permissions allow an extension to do in general.
GitHub Enterprise pre-configuration
You can pre-configure an OAuth app to authenticate against your enterprise installation using Firefox Enterprise Policies. See the README of this extension on GitHub for details: https://github.com/freaktechnik/advanced-github-notifier/blob/master/README.md#pre-configuring-a-github-enterprise-oauth-app
Alert sounds
If you want sounds for you notifications and Firefox doesn't make a sound by default, you can use the Notification Sound extension to get a sound whenever a notification is displayed.
Source Code, Bugs and Feature requests
The source of this extension is hosted on GitHub: https://github.com/freaktechnik/advanced-github-notifier/
Disclaimer
This product is not developed or run by GitHub. It is a hobbyist project that uses the official GitHub API to display information about the notifications of a user on the GitHub platform. GitHub and the associated imagery are subject to copyright and trademarks of GitHub, Inc.