{"id":15484602,"url":"https://github.com/sirbrillig/gitnews-menubar","last_synced_at":"2026-04-17T23:10:38.903Z","repository":{"id":21487809,"uuid":"90803977","full_name":"sirbrillig/gitnews-menubar","owner":"sirbrillig","description":"Display GitHub notifications in your menu bar","archived":false,"fork":false,"pushed_at":"2026-04-06T16:21:23.000Z","size":10156,"stargazers_count":30,"open_issues_count":11,"forks_count":4,"subscribers_count":2,"default_branch":"trunk","last_synced_at":"2026-04-06T18:19:46.745Z","etag":null,"topics":["github","github-notifications","menubar","nodejs","notifications"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sirbrillig.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-05-10T00:30:14.000Z","updated_at":"2026-04-06T16:21:28.000Z","dependencies_parsed_at":"2023-02-18T08:31:26.881Z","dependency_job_id":"76791d8d-5462-45cf-9ea0-53236e743e4c","html_url":"https://github.com/sirbrillig/gitnews-menubar","commit_stats":null,"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/sirbrillig/gitnews-menubar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirbrillig%2Fgitnews-menubar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirbrillig%2Fgitnews-menubar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirbrillig%2Fgitnews-menubar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirbrillig%2Fgitnews-menubar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sirbrillig","download_url":"https://codeload.github.com/sirbrillig/gitnews-menubar/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirbrillig%2Fgitnews-menubar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31564915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["github","github-notifications","menubar","nodejs","notifications"],"created_at":"2024-10-02T05:41:22.140Z","updated_at":"2026-04-08T17:00:36.347Z","avatar_url":"https://github.com/sirbrillig.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gitnews\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./gitnews-menubar-app-icon.png\" /\u003e\n\u003c/p\u003e\n\nAn app to display GitHub and GitHub Enterprise notifications in your Mac OS menu bar.\n\n\u003cimg src=\"./gitnews-demo.png\" /\u003e\n\nhttps://user-images.githubusercontent.com/2036909/212501847-f298251e-ab6e-4439-88f8-696a5b0d2edd.mov\n\n## Why not use another app?\n\nThere are several other apps that are similar to this one. Notably, you might want to check out:\n\n- [Octobox](https://octobox.io/)\n- [DevHub](https://devhubapp.com/)\n- [Gitify](https://www.gitify.io/)\n- [Trailer](http://ptsochantaris.github.io/trailer/)\n\nHowever, Gitnews has several unique features that I love and I hope you'll like them too:\n\n- Supports light and dark modes.\n- Supports notifications on private repos.\n- Shows read notifications as well as unread ones.\n- Allows marking notifications as unread or unsubscribing.\n- Allows temporarily muting notifications from repos that you want to exclude.\n- Allows holding down the Command key to open or mark multiple notifications read at once.\n- The menubar icon is different when there are notifications that you've seen but not read.\n\n## Icons\n\nGitnews has three icons that you'll normally see:\n\n\u003cimg width=\"45\" alt=\"read\" src=\"https://user-images.githubusercontent.com/2036909/212502174-6713ca3d-7a02-4b0e-98c9-1a640b4ddfaa.png\"\u003e No unread notifications.\n\n\u003cimg width=\"45\" alt=\"unread\" src=\"https://user-images.githubusercontent.com/2036909/212502177-f3e0bb29-65b2-4fe6-bda6-3815c9da6f56.png\"\u003e Unread notifications that you've already seen. This means there are unread notifications but nothing new since the last time you clicked.\n\n\u003cimg width=\"45\" alt=\"unseen-unread\" src=\"https://user-images.githubusercontent.com/2036909/212502180-9a8e1317-bec8-433d-be32-a25a1eb3bf59.png\"\u003e Unseen notifications. This means that there are notifications that probably just arrived.\n\n## ✨ Download ✨\n\nCurrently 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).\n\n👉 Visit [the releases page](https://github.com/sirbrillig/gitnews-menubar/releases) to download an image of the latest release.\n\nWhen you run Gitnews, you will need to generate an API key from your GitHub account. The app will guide you through creating one.\n\n## Bug reports\n\n💣 If you have any trouble with Gitnews, please [create an issue](https://github.com/sirbrillig/gitnews-menubar/issues/new) to describe what happened.\n\n## Attributions\n\n\u003cimg src=\"./static/images/BellNormalTemplate.png\" /\u003e App icons based on images from \u003ca href=\"https://iconoir.com/\" title=\"iconoir\"\u003eIconoir\u003c/a\u003e ( \u003ca href=\"https://github.com/iconoir-icons/iconoir/blob/main/LICENSE\" title=\"MIT License\"\u003eMIT\u003c/a\u003e).\n\n## Development\n\nTo 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`.\n\nRather 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:\n\n```\nGITNEWS_DEMO_MODE=y\n```\n\n### Logging\n\nThe 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`.\n\n### Building a package\n\nTo 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).\n\nNext run the following command: `yarn run build`.\n\nYou will then find an executable application in the `out` directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirbrillig%2Fgitnews-menubar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsirbrillig%2Fgitnews-menubar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirbrillig%2Fgitnews-menubar/lists"}