{"id":13513637,"url":"https://github.com/bmartin5692/bumper","last_synced_at":"2025-03-31T02:32:45.931Z","repository":{"id":36799744,"uuid":"165171998","full_name":"bmartin5692/bumper","owner":"bmartin5692","description":"A standalone and self-hosted implementation of the central server used by Ecovacs vacuum robots.","archived":false,"fork":false,"pushed_at":"2024-08-05T10:12:30.000Z","size":25833,"stargazers_count":298,"open_issues_count":52,"forks_count":49,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-11-01T17:36:52.415Z","etag":null,"topics":["deebot","ecovacs","ozmo","self-hosted","vacuum"],"latest_commit_sha":null,"homepage":"","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/bmartin5692.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-11T03:21:26.000Z","updated_at":"2024-10-30T21:03:06.000Z","dependencies_parsed_at":"2023-01-17T05:00:41.384Z","dependency_job_id":null,"html_url":"https://github.com/bmartin5692/bumper","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/bmartin5692%2Fbumper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmartin5692%2Fbumper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmartin5692%2Fbumper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmartin5692%2Fbumper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bmartin5692","download_url":"https://codeload.github.com/bmartin5692/bumper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246407346,"owners_count":20772114,"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":["deebot","ecovacs","ozmo","self-hosted","vacuum"],"created_at":"2024-08-01T05:00:33.556Z","updated_at":"2025-03-31T02:32:43.244Z","avatar_url":"https://github.com/bmartin5692.png","language":"Python","funding_links":[],"categories":["Python","Projects"],"sub_categories":[],"readme":"![License GPLv3](https://img.shields.io/github/license/bmartin5692/bumper.svg?color=brightgreen)\n\n# Bumper \n\nBumper is a standalone and self-hosted implementation of the central server used by Ecovacs vacuum robots.  Bumper allows you to have full control of your Ecovacs robots, without the robots or app talking to the Ecovacs servers and transmitting data outside of your home.\n\n![Bumper Diagram](./docs/images/BumperDiagram.png \"Bumper Diagram\")\n\n**Note:** The current master branch is unstable, and in active development.\n\n## Build Status\n\n| Master Branch | Status                                                                 |\n| ------------------- | ---------------------------------------------------------------------- |\n| AppVeyor (Win32)    | [![AppVeyor branch](https://img.shields.io/appveyor/ci/bmartin5692/bumper/master?logo=appveyor)](https://ci.appveyor.com/project/bmartin5692/bumper/branch/master) |\n| TravisCI (Linux)    | [![Travis (.org) branch](https://img.shields.io/travis/bmartin5692/bumper/master?logo=travis)](https://travis-ci.com/bmartin5692/bumper/branch/master) |\n| Docker Hub\t      | [![Docker Build](https://img.shields.io/docker/cloud/build/bmartin5692/bumper?logo=docker)](https://hub.docker.com/r/bmartin5692/bumper/branch/master) |\n| CodeCov Coverage    | [![Codecov branch](https://img.shields.io/codecov/c/github/bmartin5692/bumper/master?logo=codecov)](https://codecov.io/gh/bmartin5692/bumper/branch/master) |\n\n\n**Community**:\nA Gitter community has been created for Bumper so users can chat and dig into issues outside of Github, join us here:\n[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/ecovacs-bumper/community)\n\n\n***Testing needed***\nBumper needs users to assist with testing in order to ensure compatability as bumper moves forward!  If you've tested Bumper with your bot, please open an issue with details on success or issues.\n\n***Please note**: this software is experimental and not ready for production use. Use at your own risk.* \n\n## Why?\n\nFor fun, mostly :)\n\nBut seriously, there are a several reasons for eliminating the central server:\n\n1. Convenience: It works without an internet connection or if Ecovacs servers are down\n2. Performance: No need for messages to travel to Ecovacs server and back.\n3. Security: We can completely isolate the robot from the public Internet.\n \n## Compatibility\n\nAs work to reverse the protocols and provide a self-hosted central server is still in progress, Bumper has had limited testing.  There are a number of EcoVacs models that it hasn't been tested against.  Bumper should be compatible with most wifi-enabled robots that use either the Ecovacs Android/iOS app or the Ecovacs Home Android/iOS app, but has only been reported to work on the below:\n\n| Model           | Protocol Used | Bumper Version Tested | EcoVacs App Tested   |\n| --------------- | ------------- | --------------------- | -------------------- |\n| Deebot 900/901  | MQTT          | master                | Ecovacs/Ecovacs Home |\n| Deebot 600      | MQTT          | master                | Ecovacs Home         |\n| Deebot Ozmo 950 | MQTT          | master                | Ecovacs Home         |\n| Deebot Ozmo 601 | XMPP          | master                | Ecovacs              |\n| Deebot Ozmo 930 | XMPP          | master                | Ecovacs              |\n| Deebot M81 Pro  | XMPP          | v0.1.0                | Ecovacs              |\n\n## Documentation and Getting Started\n\nSee the documentation on [Read the Docs](https://bumper.readthedocs.io)\n\n---\n### Thanks\nA big thanks to the original project creator @torbjornaxelsson, without his work this project would have taken much longer to build. \n\nBumper wouldn't exist without [Sucks](https://github.com/wpietri/sucks), an open source client for Ecovacs robots. Thanks to @wpietri and contributors!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmartin5692%2Fbumper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbmartin5692%2Fbumper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmartin5692%2Fbumper/lists"}