{"id":18258137,"url":"https://github.com/sidneys/notificationcenter-settings-macos","last_synced_at":"2026-02-13T21:20:40.556Z","repository":{"id":76816360,"uuid":"63021004","full_name":"sidneys/notificationcenter-settings-macos","owner":"sidneys","description":"Exposes a streamlined interface to the Notification Center settings for macOS applications.","archived":false,"fork":false,"pushed_at":"2016-07-13T11:08:28.000Z","size":22,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-20T08:22:41.447Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sidneys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2016-07-10T22:26:05.000Z","updated_at":"2022-02-08T21:45:44.000Z","dependencies_parsed_at":"2023-04-23T13:04:06.684Z","dependency_job_id":null,"html_url":"https://github.com/sidneys/notificationcenter-settings-macos","commit_stats":{"total_commits":15,"total_committers":1,"mean_commits":15.0,"dds":0.0,"last_synced_commit":"9a9f551dd2b1372829083452e240b10a411a37ae"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sidneys/notificationcenter-settings-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidneys%2Fnotificationcenter-settings-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidneys%2Fnotificationcenter-settings-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidneys%2Fnotificationcenter-settings-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidneys%2Fnotificationcenter-settings-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sidneys","download_url":"https://codeload.github.com/sidneys/notificationcenter-settings-macos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidneys%2Fnotificationcenter-settings-macos/sbom","scorecard":{"id":822594,"data":{"date":"2025-08-11","repo":{"name":"github.com/sidneys/notificationcenter-settings-macos","commit":"9a9f551dd2b1372829083452e240b10a411a37ae"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.6,"checks":[{"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":"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":"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":"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":"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":"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":"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/16 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":"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":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"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":"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"}}]},"last_synced_at":"2025-08-23T15:57:16.934Z","repository_id":76816360,"created_at":"2025-08-23T15:57:16.934Z","updated_at":"2025-08-23T15:57:16.934Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278670927,"owners_count":26025738,"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-10-06T02:00:05.630Z","response_time":65,"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":[],"created_at":"2024-11-05T10:29:17.585Z","updated_at":"2025-10-06T19:43:10.868Z","avatar_url":"https://github.com/sidneys.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# notificationcenter-settings-macos\n[![Gitter](https://badges.gitter.im/sidneys/notificationcenter-settings-macos.svg)](https://gitter.im/sidneys/notificationcenter-settings?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge) [![issues](https://img.shields.io/github/issues/sidneys/notificationcenter-settings.svg)](https://github.com/sidneys/notificationcenter-settings-macos/issues)\n\n---   \n\n**Exposes a streamlined interface to the [Notification Center](https://en.wikipedia.org/wiki/Notification_Center) settings for OSX / macOS applications.**\n\n--- \n\n\n## Contents\n\n1. [Platforms](#platforms)\n1. [Programmatic Usage](#programmatic-usage)\n1. [Commandline Interface](#commandline-interface) \n1. [API](#api)\n1. [Tests](#tests)\n1. [Under the Hood](#under-the-hood)\n1. [Author](#author)\n\n\n## \u003ca name=\"platforms\"\u003e\u003c/a\u003ePlatforms\n\n - Tested on Yosemite, El-Capitan and Sierra (10.10 upward).\n\n \n## \u003ca name=\"programmatic-usage\"\u003e\u003c/a\u003eProgrammatic Usage\n\nInstall it\n\n```bash\n$ npm install --save notificationcenter-settings\n```\n\nRequire it\n\n```js\nvar ncSettings = require('notificationcenter-settings');\n```\n\nUse the **get()** callback to parse settings:\n\n```js\nncSettings.get('com.apple.iTunes', function(err, result) {\n\tif (err) return err;\n\tconsole.dir(result);\n};\n```\nResult:\n\n```\n{\n    isHidden: false,\n    showBadge: true,\n    playSound: true,\n    isBanner: true,\n    isAlert: false,\n    hideInLockscreen: false,\n    showPreview: false,\n    hidePreview: false\n}\n```\n\n\n## \u003ca name=\"commandline-interface\"\u003e\u003c/a\u003eCommandline Interface\n\nInstall the module globally:\n\n```bash\nnpm install --global notificationcenter-settings\n```\n\nRun the provided **nc-settings** executable:\n\n```bash\n$ nc-settings com.apple.iTunes\n```\n\nResult:\n\n```bash\nNotification Center settings for \"com.apple.iTunes\":\n{\n    \"isHidden\": false,\n    \"showBadge\": true,\n    \"playSound\": true,\n    \"isBanner\": true,\n    \"isAlert\": false,\n    \"hideInLockscreen\": false,\n    \"showPreview\": false,\n    \"hidePreview\": false\n}\n```\n\n\n## \u003ca name=\"api\"\u003e\u003c/a\u003eAPI\n\n### `get(bundleId, callback)`\n\nGet current Notification Center settings for app using bundleId.\n\n - **String *bundleId* - Bundle identifier for the callback function**\n - **Function *callback* - The function to call to start Notification Center parsing**\n\n**Returns:**  \n - *Object* with the following properties:\n\n - isHidden  **Show in Notification center**\n - showBadge  **Show badge app icon**\n - playSound  **Play sound for notifications**\n - isBanner  **Show as banner**\n - isAlert  **Show as alert**\n - hideInLockscreen  **Hide notifications on lock screen**\n - showPreview  **Show message preview**\n - hidePreview  **Hide message preview**\n \n\n### `path()`\n\nGet absolute path to Notification Center database file.  \n\n*See also ['Getting the bundle identifier of an OS X application in a shell script'](http://superuser.com/questions/346369/getting-the-bundle-identifier-of-an-os-x-application-in-a-shell-script)*\n\n**Returns:**  \n* *String* containing the absolute path to the database file\n\n## \u003ca name=\"tests\"\u003e\u003c/a\u003eTests\n\n```bash\nnpm test\n```\n    \n## \u003ca name=\"under-the-hood\"\u003e\u003c/a\u003eUnder the hood\n\nThe module parses the default Sqlite3 .db database for **com.apple.notificationcenter**.\nThe contained bit flags for each application identifier contain its current settings.\n\n\n## \u003ca name=\"author\"\u003e\u003c/a\u003eAuthor\n\n [Sidney Bofah](http://sidneys.github.io)\n \n Thanks goes to the [NCUtil](https://github.com/jacobsalmela/NCutil) project for laying out the baseline implementation in Python.\n\n## Badge\n\n[![badge](https://nodei.co/npm/notificationcenter-settings.png?downloads=true)](https://www.npmjs.com/package/notificationcenter-settings)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsidneys%2Fnotificationcenter-settings-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsidneys%2Fnotificationcenter-settings-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsidneys%2Fnotificationcenter-settings-macos/lists"}