{"id":28138921,"url":"https://github.com/cavefire/cn360-homeassistant","last_synced_at":"2025-05-14T17:18:32.459Z","repository":{"id":289897118,"uuid":"972748237","full_name":"cavefire/cn360-homeassistant","owner":"cavefire","description":"360.cn / Botslab 360 Vacuum Robot integration for Home Assistant","archived":false,"fork":false,"pushed_at":"2025-04-25T16:35:49.000Z","size":35,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-25T16:51:46.996Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cavefire.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,"zenodo":null}},"created_at":"2025-04-25T15:39:52.000Z","updated_at":"2025-04-25T16:35:53.000Z","dependencies_parsed_at":"2025-04-25T17:02:36.620Z","dependency_job_id":null,"html_url":"https://github.com/cavefire/cn360-homeassistant","commit_stats":null,"previous_names":["cavefire/cn360-homeassistant"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cavefire%2Fcn360-homeassistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cavefire%2Fcn360-homeassistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cavefire%2Fcn360-homeassistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cavefire%2Fcn360-homeassistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cavefire","download_url":"https://codeload.github.com/cavefire/cn360-homeassistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254190411,"owners_count":22029639,"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":"2025-05-14T17:15:27.993Z","updated_at":"2025-05-14T17:18:32.454Z","avatar_url":"https://github.com/cavefire.png","language":"Python","funding_links":["https://www.buymeacoffee.com/cavefire"],"categories":[],"sub_categories":[],"readme":"# 360 / Qihoo / Botslab 360 Vacuum Robot Home Assistant Integration\n\nThis is a custom component for Home Assistant to integrate with 360 vacuum robots.\nYou will need this proxy server running for this integration to work: https://github.com/cavefire/cn360-proxy\n\n## Installation\n\n### Using HACS\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?category=integration\u0026repository=cn360-homeassistant\u0026owner=cavefire)\n\n1. Click the link above to open the integration in HACS.\n2. Install the integration.\n\n### Manual Installation\n\n1. Clone or download this repository.\n2. Copy the `custom_components/cn360` directory to your Home Assistant `config` directory.\n3. Restart Home Assistant.\n\n## Setup\n\n1. Go to \"Configuration\" -\u003e \"Devices \u0026 Services\" -\u003e \"Add Device\" -\u003e \"CN360\".\n2. Enter the host and port of your proxy and click \"Add\"\n\n## Proxy\n\nAs far as I could figure out, there is no native way to control the vacuum robot fully locally. Since the servers of 360 (Qihoo 360 / Botslab 360 and so many more names...) \nare mostly located in China, controlling the robots sends the traffic halfway around the world for me.\n\nBecause of this reason, I created a proxy (https://github.com/cavefire/cn360-proxy), which acts as a Man in the Middle, to capture the events from the robot and send commands to it. **The proxy is needed for this\nintegration to work!**\n\n## Features\n\nThis is the list of features implemented in the integration. Non-marked features are not yet implemented. Feel free to do so!\n\n- [x] Start cleaning\n- [x] Pause cleaning\n- [x] Back to dock / Charging\n- [x] Battery status\n- [x] Current map view with postion\n- [x] General settings\n- [x] Reboot\n- [x] Locate  \n- [ ] Path on map\n- [ ] Switch between maps\n- [ ] Upload custom sound packs\n- [ ] Mop and / or vacuum selection\n- [ ] Water amount\n- [ ] Cleaning amount\n- [ ] Cleaning schedule\n\n### Supported Devices\n\n- [x] S9\n\nI only have this one to test.\n\nIf you have a device that is not listed here, please open an issue or a pull request.\nThese devices only work with the features that are marked as completed above.\n**If a feature is missing on your device, please open an issue.**\n\n## Contributing\nThis project is a work in progress, and contributions are welcome!\nIf you encounter issues, have feature requests, or want to contribute, feel free to submit a pull request or open an issue.\n\nIf you like this project, consider supporting me \n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/cavefire)\n\n\n## Disclaimer\nThis project is not affiliated with Qihoo 360 Technology Co. Ltd. The API and all functions are reverse-engineered and may break at any time. Use at your own risk.\n\n**To the Qihoo 360 legal team:**\nI found out all the functions with my own device and did not use any copyright-protected data. This activity is legally protected in Germany.\nHowever, if there are any concerns, we will surely find a way to mitigate them together.\n\n## License\nThis project is licensed under GNU GPLv3 - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcavefire%2Fcn360-homeassistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcavefire%2Fcn360-homeassistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcavefire%2Fcn360-homeassistant/lists"}