{"id":15022086,"url":"https://github.com/bytespider/meross","last_synced_at":"2025-04-04T11:08:57.694Z","repository":{"id":37144896,"uuid":"168860175","full_name":"bytespider/Meross","owner":"bytespider","description":"Investigating the Meross / Refoss MSS310 Smart Plug and getting these devices to communicate with our private MQTT brokers","archived":false,"fork":false,"pushed_at":"2025-01-25T14:39:11.000Z","size":9076,"stargazers_count":120,"open_issues_count":4,"forks_count":20,"subscribers_count":11,"default_branch":"develop","last_synced_at":"2025-04-04T11:08:52.231Z","etag":null,"topics":["hardware-hacking","home-assistant","homeassistant","meross","mqtt-smarthome","refoss","smarthome"],"latest_commit_sha":null,"homepage":"","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/bytespider.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":"2019-02-02T17:53:07.000Z","updated_at":"2025-03-22T22:07:11.000Z","dependencies_parsed_at":"2023-02-09T20:15:19.318Z","dependency_job_id":"711f0e11-79b6-4722-9c38-17437f72cb95","html_url":"https://github.com/bytespider/Meross","commit_stats":{"total_commits":68,"total_committers":7,"mean_commits":9.714285714285714,"dds":0.3382352941176471,"last_synced_commit":"109a3169fe311f98fbcb33e59630d9e50bb62a8d"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytespider%2FMeross","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytespider%2FMeross/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytespider%2FMeross/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytespider%2FMeross/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bytespider","download_url":"https://codeload.github.com/bytespider/Meross/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247166167,"owners_count":20894654,"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":["hardware-hacking","home-assistant","homeassistant","meross","mqtt-smarthome","refoss","smarthome"],"created_at":"2024-09-24T19:57:26.411Z","updated_at":"2025-04-04T11:08:57.673Z","avatar_url":"https://github.com/bytespider.png","language":"JavaScript","readme":"# Meross utilities\n\n[![Node.js Package](https://github.com/bytespider/Meross/actions/workflows/npm-ghr-publish.yml/badge.svg)](https://github.com/bytespider/Meross/actions/workflows/npm-ghr-publish.yml)\n\nTools to help configure the Meross devices for purpose of utilising our \u003ca href=\"https://github.com/bytespider/Meross/wiki/MQTT\"\u003eown MQTT servers\u003c/a\u003e.\n\nBefore you can use the tool to setup your device you need to put it into paring mode and connect to it's Access Point. It's IP address is known as the `--gateway` parameter and is typically `10.10.10.1`.\n\nRequires `node` \u003e=18  \nFor Node.js \u003e=21 you need to prepend commands with `NODE_OPTIONS='--insecure-http-parser'`. This is because the responses from some (if not all) versions of the Meross firmware incorrectly terminate headers with LF instead of CRLF. [CVE-2022-32214](https://nvd.nist.gov/vuln/detail/CVE-2022-32214)\n\n## Home Assistant\n\nIt's possible to get these devices to work with Home Assistant (HASSIO).\n\u003ca href=\"https://github.com/bytespider/Meross/wiki/Home-Assistant-(HASSIO)\"\u003eSetup Home Assistant MQTT\u003c/a\u003e\n\nOnce paired and linked to your broker, you can use the \u003ca href=\"https://github.com/krahabb/meross_lan\"\u003eMeross Lan\u003c/a\u003e integration to control the devices.\n\n## Tools\n\n### Info\n\n`npx meross info [--include-wifi]`\nGets information from the device you are connected to in setup mode and optionally the WIFI SSID's it can see.\n\n### Setup\n\n`npx meross setup [options]`\nSetup device you are connected to in setup mode\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytespider%2Fmeross","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbytespider%2Fmeross","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytespider%2Fmeross/lists"}