GitHub Notifications

A secure, customizable, statusbar icon that notifies you about notifications on GitHub.

You can customize it to your likings, choose when to show it and which icon/color/browser to use.

Install

Follow the instructions in the Marketplace, or run the following in the command palette:

ext install fabiospampinato.vscode-github-notifications-bell

Usage

It adds 2 commands to the command palette:

'GitHub Notifications: Refresh' // Refresh the notifications
'GitHub Notifications: Open in Browser' // Open the notifications page in the browser

Settings

This extension requires you to provide an OAuth token, to create it go here, click "Generate new token" and be sure to select the "notifications" scope, then click "Generate token".

{
  "githubNotificationsBell.refreshInterval": 300, // Amount of seconds to wait before each refresh
  "githubNotificationsBell.oauthToken": "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", // OAuth token used for requesting the notifications
  "githubNotificationsBell.alignment": "right", // Bell's position in the statusbar (left/right)
  "githubNotificationsBell.icon": "mark-github", // The icon to use in the statusbar
  "githubNotificationsBell.color": "", // Bell's color when there are some notifications
  "githubNotificationsBell.hideIfNone": true, // Hide the bell if there are no notifications
  "githubNotificationsBell.showNumberOfNotifications": true // Show the number of notifications alongside the bell icon
  "githubNotificationsBell.domain": "github.com" // The Github domain to query against. Github Enterprise may use a different domain
}

You can provide your OAuth token also by setting an environment variable named: GITHUB_NOTIFICATIONS_TOKEN.

Demo

Hints

• Icon: Here you can browse a list of supported icons. If for instance you click the first icon, you'll get a page with .octicon-alert written in it, to get the string to use simply remove the .octicon- part, so in this case the icon name would be alert.

Contributing

If you found a problem, or have a feature request, please open an issue about it.

If you want to make a pull request you can debug the extension using Debug Launcher.

License

MIT © Fabio Spampinato