https://github.com/sirbrillig/gitnews-menubar
Display GitHub notifications in your menu bar
https://github.com/sirbrillig/gitnews-menubar
github github-notifications menubar nodejs notifications
Last synced: about 2 months ago
JSON representation
Display GitHub notifications in your menu bar
- Host: GitHub
- URL: https://github.com/sirbrillig/gitnews-menubar
- Owner: sirbrillig
- License: gpl-2.0
- Created: 2017-05-10T00:30:14.000Z (about 9 years ago)
- Default Branch: trunk
- Last Pushed: 2026-04-06T16:21:23.000Z (2 months ago)
- Last Synced: 2026-04-06T18:19:46.745Z (2 months ago)
- Topics: github, github-notifications, menubar, nodejs, notifications
- Language: TypeScript
- Homepage:
- Size: 9.69 MB
- Stars: 30
- Watchers: 2
- Forks: 4
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Gitnews
An app to display GitHub and GitHub Enterprise notifications in your Mac OS menu bar.
https://user-images.githubusercontent.com/2036909/212501847-f298251e-ab6e-4439-88f8-696a5b0d2edd.mov
## Why not use another app?
There are several other apps that are similar to this one. Notably, you might want to check out:
- [Octobox](https://octobox.io/)
- [DevHub](https://devhubapp.com/)
- [Gitify](https://www.gitify.io/)
- [Trailer](http://ptsochantaris.github.io/trailer/)
However, Gitnews has several unique features that I love and I hope you'll like them too:
- Supports light and dark modes.
- Supports notifications on private repos.
- Shows read notifications as well as unread ones.
- Allows marking notifications as unread or unsubscribing.
- Allows temporarily muting notifications from repos that you want to exclude.
- Allows holding down the Command key to open or mark multiple notifications read at once.
- The menubar icon is different when there are notifications that you've seen but not read.
## Icons
Gitnews has three icons that you'll normally see:
No unread notifications.
Unread notifications that you've already seen. This means there are unread notifications but nothing new since the last time you clicked.
Unseen notifications. This means that there are notifications that probably just arrived.
## ✨ Download ✨
Currently the packaged version of Gitnews is only built for Mac OS but the app could work on any platform. If anyone wants to try running it in Windows or Linux I'd be happy to discuss adding support; please [create an issue](https://github.com/sirbrillig/gitnews-menubar/issues/new).
👉 Visit [the releases page](https://github.com/sirbrillig/gitnews-menubar/releases) to download an image of the latest release.
When you run Gitnews, you will need to generate an API key from your GitHub account. The app will guide you through creating one.
## Bug reports
💣 If you have any trouble with Gitnews, please [create an issue](https://github.com/sirbrillig/gitnews-menubar/issues/new) to describe what happened.
## Attributions
App icons based on images from Iconoir ( MIT).
## Development
To run the development version from the source, first install all dependencies by running `yarn` (you must have [yarn](https://yarnpkg.com/en/) installed for this to work). Next run the command `yarn start`.
Rather than use real data, you can use mock data by enabling demo mode. This also disables network side effects (like marking a notification as read). To do this, create a `.env` file in the source directory and include the following:
```
GITNEWS_DEMO_MODE=y
```
### Logging
The app logs its activity to a file on the local machine using the library [electon-log](https://github.com/megahertz/electron-log). On the Mac OS this produces a file in `~/Library/Logs/Gitnews/main.log`.
### Building a package
To create a packaged Mac OS App, first install dependencies by running `yarn` (you must have [yarn](https://yarnpkg.com/en/) installed for this to work).
Next run the following command: `yarn run build`.
You will then find an executable application in the `out` directory.