{"id":13830458,"url":"https://github.com/bureus/MMM-Nightscout","last_synced_at":"2025-07-09T11:33:05.531Z","repository":{"id":93986565,"uuid":"171733897","full_name":"bureus/MMM-Nightscout","owner":"bureus","description":"Magic Mirror Module - That displays current glucose level from the open source project Nightscout","archived":false,"fork":false,"pushed_at":"2024-01-09T22:03:51.000Z","size":107,"stargazers_count":14,"open_issues_count":1,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-08-04T10:03:09.818Z","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/bureus.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}},"created_at":"2019-02-20T19:14:51.000Z","updated_at":"2024-08-04T10:03:09.819Z","dependencies_parsed_at":"2023-04-14T09:03:15.518Z","dependency_job_id":null,"html_url":"https://github.com/bureus/MMM-Nightscout","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bureus%2FMMM-Nightscout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bureus%2FMMM-Nightscout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bureus%2FMMM-Nightscout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bureus%2FMMM-Nightscout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bureus","download_url":"https://codeload.github.com/bureus/MMM-Nightscout/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539402,"owners_count":17485320,"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","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-08-04T10:01:00.330Z","updated_at":"2024-11-20T11:30:48.208Z","avatar_url":"https://github.com/bureus.png","language":"JavaScript","funding_links":[],"categories":["Fitness"],"sub_categories":[],"readme":"# MMM-Nightscout\n[Magic Mirror](https://magicmirror.builders/) Module - Keep track of blood glucose levels with ease thru your magic mirror. Display real time blood glucose levels, with trends and warnings. Powered by [Nightscout](http://www.nightscout.info/)\n\n## Prerequisites and requirments\n1. You need to have Nightscout enabled CGM \n2. You need to setup your own Nightscout website, please follow this [tutorial](http://www.nightscout.info/wiki/welcome)\n\n## Install\n1. Clone repository into ``../modules/`` inside your MagicMirror folder.\n2. Run ``npm install`` inside ``../modules/MMM-Nightscout/`` folder\n3. Add the module to the MagicMirror config\n\n## Update\n1. Run ``git pull`` inside ``../modules/MMM-Nightscout/`` folder.\n2. Run ``npm install`` inside ``../modules/MMM-Nightscout/`` folder\n\n## Configuration\nMMM-Nighscout works with any public hosted Nightscout instance. Important is to verify that your instance is accessible over the public internet by visiting http(s)://YOURSITE (Example Azure: https://YOURSITENAMEHERE.azurewebsites.net or Heroku: https://YOURSITENAMEHERE.herokuapp.com). Please also verify that your site is showing your data as well before proceeding.\n\n\nIt is possible to use tokens for authenticating as well. The following is needed to set it up:\n1. Create a role with \"api:*:read\" as permissions.\n2. Create a subject and set it to use the role created in step 1.\n3. Copy the \"Access token\" from step 2 and paste into the config.js file in the \"token\" field.\n```\nmodules: [\n    ...\n    {\n        module: \"MMM-Nightscout\",\n            position: \"top_left\",\n            config: {\n                debug: true, //Optional: set to true if you want debug logs\n                baseUrl: 'https://YOURSITENAMEHERE.azurewebsites.net', //Required: Base url to your Nightscout webapplication. Please make sure to not have any traling /\n                colorEnabled: true, //Optional: set to true if you want to get colorful bs values. Default is false.\n                chartWidth: 350,  //Optional: set chart width in px. Default is 350px.\n                chartHours: 4, //Optional: number of hours that chart tracks. Default is 4. \n                renderChart: true,  //Optional: set to false if you dont want to get a chart. Default is true.\n                token: false, //Optional: use a token to authenticate against the Nightscout server.\n                showTIR: false, //Optional: set to true if you want to display TIR for the last \u003cchartHours\u003e number of hours.\n                units: false, //Optional: set to \"mmol\" to overwrite server settings and display data in mmol/L in case setting isn't read properly.\n                extendedHeader: false //Option: set to false if you want to hide server title and last glucose value.\n        }\n    },\n    ...\n]\n```\n\n## Chart\nNightscout similar chart that has fully configurable dimensions. Support for color coding and possibility of tracking up to 24hrs of data.\n\n![Nightscout Module](docs/screenshot-4.PNG)\n\n![Nightscout Module](docs/screenshot-5.PNG)\n\nTime in range calculation for displayed chart.\n\n![Nightscout Module](docs/time_in_range.png)\n\n## Configs retrieved from Nightscout\nSupports both mmol/L and mg/dL\n\nmmol/L\n\n![Nightscout Module](docs/screenshot.PNG)\n\nmg/dL\n\n![Nightscout Module](docs/screenshot-2.PNG)\n\n## Color theme\nSet colorEnabled = true to render blood glucose level based on Nightscout thresholds (critical, warning, normal). Default is false. \n\n![Nightscout Module](docs/screenshot-3.PNG)\n\n\n## Screenshot\n\n![Nightscout Module](docs/screenshot.PNG)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbureus%2FMMM-Nightscout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbureus%2FMMM-Nightscout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbureus%2FMMM-Nightscout/lists"}