{"id":20442456,"url":"https://github.com/plibither8/github-feed-notifier","last_synced_at":"2025-08-25T17:05:54.665Z","repository":{"id":107607643,"uuid":"141039775","full_name":"plibither8/github-feed-notifier","owner":"plibither8","description":":octocat::bell: Desktop notifications for your GitHub dashboard — Native, cross-platform and configurable","archived":false,"fork":false,"pushed_at":"2018-08-29T16:01:49.000Z","size":213,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-18T06:12:51.394Z","etag":null,"topics":["desktop-notifications","github","github-feed","node","notifications","notifier","npm"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/gfn","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/plibither8.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}},"created_at":"2018-07-15T15:54:02.000Z","updated_at":"2022-11-02T03:52:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"fe597535-f263-4029-ab4b-10c000b243a4","html_url":"https://github.com/plibither8/github-feed-notifier","commit_stats":{"total_commits":37,"total_committers":1,"mean_commits":37.0,"dds":0.0,"last_synced_commit":"8d8176bf42d01eefba8950eb13f7a6562ffe2877"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/plibither8/github-feed-notifier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plibither8%2Fgithub-feed-notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plibither8%2Fgithub-feed-notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plibither8%2Fgithub-feed-notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plibither8%2Fgithub-feed-notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plibither8","download_url":"https://codeload.github.com/plibither8/github-feed-notifier/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plibither8%2Fgithub-feed-notifier/sbom","scorecard":{"id":737792,"data":{"date":"2025-08-11","repo":{"name":"github.com/plibither8/github-feed-notifier","commit":"8d8176bf42d01eefba8950eb13f7a6562ffe2877"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"34 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-6chw-6frg-f759","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-3wcq-x3mq-6r9p","Warn: Project is vulnerable to: GHSA-3gx7-xhv7-5mx3","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97","Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j","Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22","Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp","Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546","Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574","Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm","Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-776f-qx25-q3cc"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-22T16:25:04.323Z","repository_id":107607643,"created_at":"2025-08-22T16:25:04.324Z","updated_at":"2025-08-22T16:25:04.324Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272100683,"owners_count":24873442,"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","status":"online","status_checked_at":"2025-08-25T02:00:12.092Z","response_time":1107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["desktop-notifications","github","github-feed","node","notifications","notifier","npm"],"created_at":"2024-11-15T09:40:23.157Z","updated_at":"2025-08-25T17:05:54.628Z","avatar_url":"https://github.com/plibither8.png","language":"JavaScript","readme":"# github-feed-notifier 🔔\n\n[![Build Status](https://img.shields.io/travis/plibither8/github-feed-notifier/master.svg?style=flat)](https://travis-ci.org/plibither8/github-feed-notifier)\n[![Number of downloads](https://img.shields.io/npm/dt/gfn.svg?style=flat)](https://www.npmjs.com/package/gfn)\n[![Licence](https://img.shields.io/npm/l/gfn.svg?maxAge=2592000\u0026style=flat)](LICENSE)\n[![Number of dependencies](https://img.shields.io/david/plibither8/gfn.svg?maxAge=2592000\u0026style=flat)](https://www.npmjs.com/package/gfn?activeTab=dependencies)\n[![Made with Love in India](https://madewithlove.org.in/badge.svg)](https://madewithlove.org.in/)\n[![npm](https://nodei.co/npm/gfn.png?mini=true)](https://www.npmjs.com/package/gfn)\n\n\n\u003e :octocat::bell: Cross-platform, native, desktop notification service for notifying when personal GitHub dashboard feed gets updated with new activity\n\n## About\n\ngithub-feed-notifier (GFN) is a small NodeJS program that produces desktop notifications when your GitHub dashboard feed is updated with a new item. The program uses [node-notifier](https://github.com/mikaelbr/node-notifier), which allows for cross-OS support (Linux, macOS and Windows).\n\n### Why\n\nThere are [quite a few](https://github.com/search?q=github+notifier) \"feed notifiers\" for GitHub, but most of them lack something that I want:\n\n* Cross-platform compatibilty\n* Configurability\n* Desktop notifications (and a not browser notification)\n* Easy installation\n\n## Usage\n\n### Installation\n\n[NodeJS](https://nodejs.org/en/download/) (and npm) is required.\n\nInstall GFN globally:\n\n```sh\n$ npm install -g gfn\n```\n\nand configure:\n\n```sh\n$ gfn config\n```\n\nOnce properly configured, GFN can be run as a foreground process in your terminal: `$ gfn` or `$ github-feed-notifier`\n\n### Configuration\n\nThe main requirement for configuration is your personal GitHub feed URL. You can obtain it by following these steps:\n\n1. Login to GitHub and go to your dashboard (the [homepage](https://github.com))\n2. Scroll down entirely, to the bottom of the feed (do not click the 'Load more' button)\n3. Click on the \"Subscribe to your news feed\" link\n\n![readme-subscribe-to-feed](assets/readme-subscribe-to-feed.png)\n\n4. Copy the URL of this link. This is your personal feed URL\n5. Run `gfn config` and paste this link\n\n**Note:** Those using [@sindresorhus](https://github.com/sindresorhus)' extension [Refined GitHub](https://github.com/sindresorhus/refined-github) will need to either disable the extension temporarily or open your dashboard in Incognito/Private Mode to view the \"Subscribe to your news feed\" link.\n\n### Run as a Background Process\n\nThough GFN can be run directly as shown above, it is meant to be run as a **background process** on your computer to prevent using an extra terminal session.\n\nTo start GFN as a background process, use [forever](https://github.com/foreverjs/forever), a simple CLI tool that allows a script to run _forever_, in the background.\n\nTo get started, install 'forever' globally:\n\n```sh\n$ npm install -g forever\n```\n\nOnce installed, start forever:\n\n```sh\n$ forever start `npm root -g`/gfn\n```\n\n### Start Automatically on System Startup\n\nThis is where it gets different for different platforms, OS's and builds. I recommend looking it up for your own platform.\n\nOne possible, cross-platform solution is to use [pm2](https://github.com/Unitech/pm2) instead of 'forever' to run the command forever, as pm2 lets you keep your process alive after every restart using [startup hooks](https://github.com/Unitech/pm2#startup-hooks-generation). But for a small project like this, pm2 might be overkill.\n\nTo get started, answers to questions on StackExchange worked for me, for [Linux](https://stackoverflow.com/questions/12973777/how-to-run-a-shell-script-at-startup) and [macOS](https://superuser.com/questions/229773/run-command-on-startup-login-mac-os-x).\n\n---\n\n## License\n\nCopyright (c) Mihir Chaturvedi. All rights reserved.\n\nLicensed under the [MIT](LICENSE) License.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplibither8%2Fgithub-feed-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplibither8%2Fgithub-feed-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplibither8%2Fgithub-feed-notifier/lists"}