{"id":50361100,"url":"https://github.com/tectiv3/r3p-mqtt","last_synced_at":"2026-05-30T01:30:36.058Z","repository":{"id":343259259,"uuid":"1176889900","full_name":"tectiv3/r3p-mqtt","owner":"tectiv3","description":"river 3 plus mqqt server","archived":false,"fork":false,"pushed_at":"2026-03-09T15:06:22.000Z","size":328,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-09T20:11:25.774Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tectiv3.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T13:36:52.000Z","updated_at":"2026-03-09T15:08:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tectiv3/r3p-mqtt","commit_stats":null,"previous_names":["tectiv3/r3p-mqtt"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/tectiv3/r3p-mqtt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tectiv3%2Fr3p-mqtt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tectiv3%2Fr3p-mqtt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tectiv3%2Fr3p-mqtt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tectiv3%2Fr3p-mqtt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tectiv3","download_url":"https://codeload.github.com/tectiv3/r3p-mqtt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tectiv3%2Fr3p-mqtt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33677258,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"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":"2026-05-30T01:30:33.082Z","updated_at":"2026-05-30T01:30:36.052Z","avatar_url":"https://github.com/tectiv3.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# r3p-mqtt\n\nA Python daemon that connects to an EcoFlow River 3 Plus over BLE and publishes telemetry to MQTT.\n\n## Requirements\n\n- Python 3.13+\n- [uv](https://docs.astral.sh/uv/)\n- Bluetooth adapter (the host must be within BLE range of the device)\n- MQTT broker (e.g. Mosquitto)\n\n## Setup\n\n```bash\ngit clone \u003crepo-url\u003e\ncd r3p-mqtt\nuv sync\ncp config.example.json config.json\n```\n\nEdit `config.json`:\n\n```json\n{\n  \"user_id\": \"YOUR_ECOFLOW_USER_ID\",\n  \"device_serial\": \"YOUR_DEVICE_SERIAL\",\n  \"mqtt\": {\n    \"host\": \"localhost\",\n    \"port\": 1883,\n    \"username\": null,\n    \"password\": null\n  },\n  \"log_level\": \"INFO\"\n}\n```\n\n- `user_id` — your EcoFlow account user ID\n- `device_serial` — serial number of the device or omit to connect to the first River 3 Plus found\n- `log_level` — `INFO` for normal operation, `DEBUG` for telemetry logging\n\n## Usage\n\n```bash\nuv run r3p-mqtt\n```\n\nThe daemon will:\n1. Scan for the River 3 Plus via BLE\n2. Connect and authenticate\n3. Publish telemetry to MQTT as values change\n4. Reconnect automatically on disconnect (exponential backoff)\n\nCtrl+C for clean shutdown.\n\n## MQTT Topics\n\nAll topics are under `ecoflow/r3p/` (configurable via `mqtt.topic_prefix`), retained, and only published on change.\n\n| Topic | Type | Description |\n|-------|------|-------------|\n| `online` | bool | `true` / `false` (LWT) |\n| `battery_level` | float | Battery percentage |\n| `ac_input_power` | float | AC input power (W) |\n| `ac_output_power` | float | AC output power (W) |\n| `dc_input_power` | float | DC input power (W) |\n| `dc12v_output_power` | float | 12V DC output power (W) |\n| `usba_output_power` | float | USB-A output power (W) |\n| `usbc_output_power` | float | USB-C output power (W) |\n| `input_power` | float | Total input power (W) |\n| `output_power` | float | Total output power (W) |\n| `cell_temperature` | float | Battery cell temperature (C) |\n| `plugged_in_ac` | bool | AC plugged in |\n| `energy_backup` | bool | Energy backup mode active |\n| `battery_charge_limit_min` | int | Min charge limit (%) |\n| `battery_charge_limit_max` | int | Max charge limit (%) |\n| `ac_charging_speed` | int | AC charging speed setting |\n| `remaining_time_charging` | int | Minutes until full |\n| `remaining_time_discharging` | int | Minutes until empty |\n\nSubscribe to all: `mosquitto_sub -t \"ecoflow/r3p/#\" -v`\n\n## Systemd\n\n```bash\nsudo useradd -r -s /usr/sbin/nologin r3pmqtt\nsudo usermod -aG bluetooth r3pmqtt\nsudo cp r3p-mqtt.service /etc/systemd/system/\nsudo systemctl daemon-reload\nsudo systemctl enable --now r3p-mqtt\njournalctl -u r3p-mqtt -f\n```\n\nThe service file assumes installation at `/opt/r3p-mqtt`. Edit `r3p-mqtt.service` if your path differs.\n\n## Acknowledgments\n\nBLE protocol implementation extracted from [ha-ef-ble](https://github.com/rabits/ha-ef-ble) by rabits, licensed under Apache 2.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftectiv3%2Fr3p-mqtt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftectiv3%2Fr3p-mqtt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftectiv3%2Fr3p-mqtt/lists"}