{"id":13403309,"url":"https://github.com/sindresorhus/notifier-for-github","last_synced_at":"2025-10-08T08:53:24.966Z","repository":{"id":16149113,"uuid":"18894771","full_name":"sindresorhus/notifier-for-github","owner":"sindresorhus","description":"Browser extension - Get notified about new GitHub notifications","archived":false,"fork":false,"pushed_at":"2024-09-18T12:33:37.000Z","size":3298,"stargazers_count":1880,"open_issues_count":19,"forks_count":133,"subscribers_count":36,"default_branch":"main","last_synced_at":"2025-05-07T09:38:10.526Z","etag":null,"topics":["browser-extension","chrome-extension","firefox-addon","github","github-extension"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sindresorhus.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"sindresorhus","open_collective":"sindresorhus","buy_me_a_coffee":"sindresorhus","custom":"https://sindresorhus.com/donate"}},"created_at":"2014-04-17T21:59:59.000Z","updated_at":"2025-05-05T17:17:31.000Z","dependencies_parsed_at":"2024-04-17T07:26:20.646Z","dependency_job_id":"061d976a-064e-4e32-96b4-ba713e3969d3","html_url":"https://github.com/sindresorhus/notifier-for-github","commit_stats":{"total_commits":191,"total_committers":45,"mean_commits":"4.2444444444444445","dds":0.6387434554973822,"last_synced_commit":"7aade100e6b4d3745406deee7bfe5d36c30353ea"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sindresorhus%2Fnotifier-for-github","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sindresorhus%2Fnotifier-for-github/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sindresorhus%2Fnotifier-for-github/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sindresorhus%2Fnotifier-for-github/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sindresorhus","download_url":"https://codeload.github.com/sindresorhus/notifier-for-github/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253618927,"owners_count":21937074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-extension","chrome-extension","firefox-addon","github","github-extension"],"created_at":"2024-07-30T19:01:28.219Z","updated_at":"2025-10-08T08:53:24.941Z","avatar_url":"https://github.com/sindresorhus.png","language":"JavaScript","funding_links":["https://github.com/sponsors/sindresorhus","https://opencollective.com/sindresorhus","https://buymeacoffee.com/sindresorhus","https://sindresorhus.com/donate"],"categories":["JavaScript"],"sub_categories":[],"readme":"# \u003cimg src=\"source/icon.png\" width=\"45\" align=\"left\"\u003e Notifier for GitHub\n\n\u003e Browser extension - Get notified about new GitHub notifications\n\nChecks for new GitHub notifications every minute, shows the number of notifications you have, and shows desktop notifications as well.\n\n## Install\n\n[link-chrome]: https://chrome.google.com/webstore/detail/notifier-for-github/lmjdlojahmbbcodnpecnjnmlddbkjhnn 'Version published on Chrome Web Store'\n[link-firefox]: https://addons.mozilla.org/en-US/firefox/addon/notifier-for-github/ 'Version published on Mozilla Add-ons'\n\n[\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/90fdf03c/src/chrome/chrome.svg\" width=\"48\" alt=\"Chrome\" valign=\"middle\"\u003e][link-chrome] [\u003cimg valign=\"middle\" src=\"https://img.shields.io/chrome-web-store/v/lmjdlojahmbbcodnpecnjnmlddbkjhnn.svg?label=%20\"\u003e][link-chrome] also compatible with [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/90fdf03c/src/edge/edge.svg\" width=\"24\" alt=\"Edge\" valign=\"middle\"\u003e][link-chrome] [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/90fdf03c/src/opera/opera.svg\" width=\"24\" alt=\"Opera\" valign=\"middle\"\u003e][link-chrome] [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/90fdf03c/src/brave/brave.svg\" width=\"24\" alt=\"Brave\" valign=\"middle\"\u003e][link-chrome]\n\n[\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/90fdf03c/src/firefox/firefox.svg\" width=\"48\" alt=\"Firefox\" valign=\"middle\"\u003e][link-firefox] [\u003cimg valign=\"middle\" src=\"https://img.shields.io/amo/v/notifier-for-github.svg?label=%20\"\u003e][link-firefox]\n\n## Highlights\n\n- [Notification count in the toolbar icon.](#notification-count)\n- [Desktop notifications.](#desktop-notifications)\n- [Filter notifications](#filtering-notifications) from repositories you wish to see.\n- [GitHub Enterprise support.](#github-enterprise-support)\n- Click the toolbar icon to go to the GitHub notifications page.\n- Option to show only unread count for issues you're participating in.\n\n*Make sure to add a token in the options.*\n\n## Screenshots\n\n### Options\n\n![Options page for Notifier for GitHub](media/screenshot-options.png)\n\n### Notification Count\n\n![Screenshot of extension should notification count](media/screenshot.png)\n## GitHub Token Setup\n\n### Token Types Supported\n\nThis extension requires a GitHub personal access token to function properly. You can follow instructions from GitHub to create a personal access token in your account.\n\n**Important:** Only classic personal access tokens are currently supported. Fine-grained personal access tokens cannot be used at this time. This limitation is tracked in an [open issue](https://github.com/sindresorhus/notifier-for-github/issues/283).\n\n### Repository Permissions\n\n#### For Private Repository Notifications\n\nTo receive desktop notifications for private repositories, you must create a personal access token with the `repo` scope. This requirement exists because of GitHub's current permission structure - accessing any information about private repositories requires full repository control permissions.\n\n#### Security Considerations\n\nIf you have security concerns about granting the `repo` scope, you can skip this permission. However, be aware of the following tradeoff:\n\n- **Without `repo` scope:** Clicking on notifications will redirect you to the general notifications homepage instead of the specific repository or issue\n- **With `repo` scope:** Clicking on notifications will take you directly to the relevant repository content\n\nThe choice between security and functionality is yours based on your comfort level with the permissions required.\n\n\n## Extension Permissions\n\nThe extension requests a couple of optional permissions. It works as intended even if you disallow these. Some features work only when you grant these permissions as mentioned below.\n\n### Tabs Permission\n\nWhen you click on the extension icon, the GitHub notifications page is opened in a new tab. The `tabs` permission lets us switch to an existing notifications tab if you already have one opened instead of opening a new one each time you click it.\n\nThis permission also lets us update the notification count immediately after opening a notification. You can find both of these options under the \"Tab handling\" section in the extension's options page.\n\n### Notifications Permission\n\nIf you want to receive desktop notifications for public repositories, you can enable them on extension options page. You will then be asked for the `notifications` permission.\n\n## Configuration\n\n### Desktop Notifications\n\n![Notification from Notifier for GitHub extension](media/screenshot-notification.png)\n\nYou can opt-in to receive desktop notifications for new notifications on GitHub. The extension checks for new notifications every minute, and displays notifications that arrived after the last check if there are any. Clicking on the notification opens it on GitHub.\n\n### Filtering Notifications\n\n![Filtering Notifications](media/screenshot-filter.png)\n\nIf you have [desktop notifications](#desktop-notifications) enabled as mentioned above, you can also filter which repositories you wish to receive these notifications from. You can do this by only selecting the repositories (that grouped by user/organization) in the options menu.\n\n### GitHub Enterprise support\n\nBy default, the extension works for the public [GitHub](https://github.com) site. If the repo of your company runs GitHub on their own servers via GitHub Enterprise Server, you have to configure the extension to use the API URL. For example `https://github.yourco.com/`.\n\n## Maintainers\n\n- [Sindre Sorhus](https://github.com/sindresorhus)\n- [Laxman Damera](https://github.com/notlmn)\n\n###### Former\n\n- [Yury Solovyov](https://github.com/YurySolovyov)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsindresorhus%2Fnotifier-for-github","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsindresorhus%2Fnotifier-for-github","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsindresorhus%2Fnotifier-for-github/lists"}