{"id":33251368,"url":"https://github.com/slametps/MMM-Tools","last_synced_at":"2025-11-21T17:02:06.715Z","repository":{"id":136058402,"uuid":"107146899","full_name":"slametps/MMM-Tools","owner":"slametps","description":"Dsiplay stats and remote controlling MagicMirror on SBC(ATB \u0026 RPI), MMM-TelegramBot supported","archived":false,"fork":false,"pushed_at":"2017-10-24T07:38:01.000Z","size":130,"stargazers_count":0,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-29T10:33:46.846Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"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/slametps.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}},"created_at":"2017-10-16T15:30:35.000Z","updated_at":"2021-01-31T16:49:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"e148a31f-302d-499b-86c1-df551881b282","html_url":"https://github.com/slametps/MMM-Tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/slametps/MMM-Tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slametps%2FMMM-Tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slametps%2FMMM-Tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slametps%2FMMM-Tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slametps%2FMMM-Tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slametps","download_url":"https://codeload.github.com/slametps/MMM-Tools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slametps%2FMMM-Tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285655011,"owners_count":27209077,"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-11-21T02:00:06.175Z","response_time":61,"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":"2025-11-17T00:00:30.829Z","updated_at":"2025-11-21T17:02:06.708Z","avatar_url":"https://github.com/slametps.png","language":"JavaScript","funding_links":[],"categories":["Mirror Utilities"],"sub_categories":[],"readme":"# MMM-Tools\nDsiplay stats and remote controlling MagicMirror on SBC(ATB \u0026amp; RPI), MMM-TelegramBot supported.\n\n## Screenshots\n![](https://github.com/eouia/MMM-Tools/blob/master/capture2.jpg)\n\non `MagicMirror`\n\n![](https://github.com/eouia/MMM-Tools/blob/master/capture1.jpg) ![](https://github.com/eouia/MMM-Tools/blob/master/capture4.jpg)\n\non `Telegram`\n\n## Feature\n- Display system status on `MagicMirror`\n- `MMM-TelegramBot` commands, `/status` and `/screen on|off` are supported.\n- You can set alert threshold for abnormal status of `MagicMirror`. You can get warning message by `notification` and `TelegramBot`\n\n## Install\n```sh\ncd [YourMagicMirrorDirectory]/modules\ngit clone https://github.com/eouia/MMM-Tools\n```\n\nIf you want to use screen capture function, you should install `scrot` additionally.\n```sh\nsudo apt-get install scrot\n```\n\n## Configuration\n```javascript\n{\n  module: 'MMM-Tools',\n  position: 'bottom_right',\n  config: {\n    device : \"ATB\", // \"RPI\" is also available\n    refresh_interval_ms : 10000,\n    warning_interval_ms : 1000 * 60 * 5,\n    enable_warning : true,\n    warning : {\n      CPU_TEMPERATURE : 65,\n      GPU_TEMPERATURE : 65,\n      CPU_USAGE : 75,\n      STORAGE_USED_PERCENT : 80,\n      MEMORY_USED_PERCENT : 80\n    }\n  }\n}\n// For more detailed information, see below;\n```\n\n### Detailed Configuration\n|field | default | description\n|--- |--- |---\n|device | `\"ATB\"` | `\"ATB\"` for **Asus TinkerBoard (TinkerOS)**, \u003cbr/\u003e`\"RPI\"` for **Raspberry Pi (Raspbian)**.\n|refresh_interval_ms | `10000` | Milliseconds for refreshing status informaion on `MagicMirror`\n|warning_interval_ms | `300000` | Milliseconds for preventing multiple warning message. After passing this duration from previous warning messages, same warning message will be sent.\n|enable_warning | `true` | Set for sending warning message (notification and `TelegramBot` message)\n|warning | See the below | Threshold values for warning message\n#### warning\n|fields | default | description\n|--- |--- |---\n| CPU_TEMPERATURE | `65` | Set CPU or SoC temperature for warning\n| GPU_TEMPERATURE | `65` | Set GPU temperature for warning\n| CPU_USAGE | `75` | Set % of CPU Usage (ref. `/proc/stat`) for warning\n| STORAGE_USED_PERCENT | `80` | Set % of used space of storage(SD Card) for warning\n| MEMORY_USED_PERCENT | `80` | Set % of used space of memory(RAM) for warning\n\n## Commands (For `MMM-TelegramBot`)\n|command | description\n|--- |---\n|`/status` | Show system status\n|`/screen on` | Turn display on\n|`/screen off` | Turn display off\n|`/capture` | Get current `MagicMirror` screenshot\n\n## Customizing view\nYou can customize view of this module with `CSS`. See the `MMM-Tools.css`\n```css\n .Tools .status_item.status_ip {\n   order: 1; // change order\n   /* display : none; */ //set display\n }\n```\n\n## For Asus Tinker Board user\n- on current TinkerOs (v 1.9), there is no `vgcencmd`, `vbetool`, `tvservice` or equivalents. So I should use `xset` for controlling screen.\n- First you should set your xset dpms and screensaver on boot like this.\n```sh\nxset s noblank\nxset s off\nxset -dpms\n\nxset s 0 0\nxset dpms 0 0 0\n```\nThere is no `/boot/config.text` in TinkerOS unlike Raspbian. I use `Xfce Power Manager` on TinkerOS LXDE desktop. (`Preference \u003e Power Manager` menu)\nSet `Blank after` and `Put to sleep after` and `Switch off after` by `Never`. It works.\n- If you have any good idea for controling screen, please tell me.\n\n\n## For Raspberry Pi(Raspbian) user\n- Don't forget setting `device:\"RPI\",` in `config.js`\n- I have no RPI currently, so I cannot test enough. Please test and report issue for this module.\n- I'm not an expert as SysAdmin, thus I don't know the best way to detect and control screen on Raspberry Pi. \n- I don't know how to detect monitor status without `xset q` on RPI. I need your help.\n\n## Updated\n### 2017-10-16\n- Indonesian translations added (Thanks to @slametps)\n- some bugs fixed.\n\n### 2017-09-01\n- Some bugs are fixed\n- `/capture` command is added.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslametps%2FMMM-Tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslametps%2FMMM-Tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslametps%2FMMM-Tools/lists"}