{"id":23989592,"url":"https://github.com/matrixeditor/meross-scripts","last_synced_at":"2025-06-15T20:34:29.655Z","repository":{"id":270207149,"uuid":"909614765","full_name":"MatrixEditor/meross-scripts","owner":"MatrixEditor","description":"Scripts to control Meross smart devices and information about the firmware.","archived":false,"fork":false,"pushed_at":"2025-01-02T13:40:10.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-07T17:33:22.929Z","etag":null,"topics":["amebaz2","meross","meross-cloud","meross-iot","rtl8720cf"],"latest_commit_sha":null,"homepage":"","language":"Python","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/MatrixEditor.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":"2024-12-29T09:00:22.000Z","updated_at":"2025-01-02T13:40:14.000Z","dependencies_parsed_at":"2024-12-29T11:37:55.043Z","dependency_job_id":null,"html_url":"https://github.com/MatrixEditor/meross-scripts","commit_stats":null,"previous_names":["matrixeditor/meross-scripts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fmeross-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fmeross-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fmeross-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixEditor%2Fmeross-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MatrixEditor","download_url":"https://codeload.github.com/MatrixEditor/meross-scripts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240599181,"owners_count":19826959,"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":["amebaz2","meross","meross-cloud","meross-iot","rtl8720cf"],"created_at":"2025-01-07T17:32:12.801Z","updated_at":"2025-02-25T03:42:36.721Z","avatar_url":"https://github.com/MatrixEditor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Meross Scripts\n\n\u003e [!NOTE]\n\u003e The tools in this repository are not feature-complete and are not intended\n\u003e to be. For more comprehensive libraries, check out [meross-iot](https://github.com/albertogeniola/MerossIot)\n\u003e and [meross_lan](https://github.com/krahabb/meross_lan)\n\nThis repository is built upon research and tools from the following excellent projects:\n* [Meross](https://github.com/bytespider/Meross) – Initial access\n* [meross-iot](https://github.com/albertogeniola/MerossIot) – Detailed protocol reference\n* [ltchiptool](https://github.com/libretiny-eu/ltchiptool) – Flash structure details\n* [Ameba-AIoT](https://github.com/orgs/Ameba-AIoT/repositories) – Chip documentation\n\n### Documents\n\nThis repository contains tools and additional information regarding hidden functionalities:\n\n* [Tools \u0026 Examples](doc/tools.md)\n* [Device \u0026 Chip Deep Dive](doc/firmware.md) (*or: how to brick and unbrick your device*)\n* [Teardown \u0026 Pinout](doc/teardown.md)\n\nMost important conclusions:\n\n- Meross uses no encryption in their firmware and within the flash, allowing to extract all possible secrets as plain text\n- The serial shell includes special commands that may brick your device\n- Using the Cloud API it is possible to register dummy devices which can be used to retrieve the firmware image\n\n\n### Key Findings\n\n- Meross' firmware is **not encrypted**, meaning all secrets stored within the firmware and flash can be easily extracted as plain text.\n- The serial shell includes **special commands** that, if used incorrectly, may brick your device.\n- It is possible to register devices using the Cloud API without providing\n  internal network data (see [Tools - Device Linking](doc/tools.md#device-linking))\n\n### Disclaimer\n\nThis repository and its associated tools are not affiliated with, endorsed by, or connected to Meross or any of its parent companies. The tools and research presented here are for educational and informational purposes only. Use them at your own risk. The author(s) of this repository do not take responsibility for any damage, data loss, or other issues caused by using the tools provided.\n\n## License\n\nDistributed under the MIT License. See LICENSE for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixeditor%2Fmeross-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatrixeditor%2Fmeross-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixeditor%2Fmeross-scripts/lists"}