{"id":20333760,"url":"https://github.com/tuxuser/abfallapi_jumomind_ha","last_synced_at":"2025-04-11T21:45:02.388Z","repository":{"id":45310216,"uuid":"240459262","full_name":"tuxuser/abfallapi_jumomind_ha","owner":"tuxuser","description":"Abfall API (Jumomind) custom component for home assistant - Get an alert when garbage collection is due","archived":false,"fork":false,"pushed_at":"2021-12-22T09:57:43.000Z","size":108,"stargazers_count":5,"open_issues_count":2,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T08:08:46.583Z","etag":null,"topics":["abfall","collection","deutschland","garbage","germany","hacs","home-assistant","homeassistant-sensor","jumomind","muell","sensor","waste"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuxuser.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}},"created_at":"2020-02-14T08:14:46.000Z","updated_at":"2025-03-01T21:31:44.000Z","dependencies_parsed_at":"2022-08-03T05:15:35.504Z","dependency_job_id":null,"html_url":"https://github.com/tuxuser/abfallapi_jumomind_ha","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/tuxuser%2Fabfallapi_jumomind_ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuxuser%2Fabfallapi_jumomind_ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuxuser%2Fabfallapi_jumomind_ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuxuser%2Fabfallapi_jumomind_ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuxuser","download_url":"https://codeload.github.com/tuxuser/abfallapi_jumomind_ha/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248487509,"owners_count":21112187,"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":["abfall","collection","deutschland","garbage","germany","hacs","home-assistant","homeassistant-sensor","jumomind","muell","sensor","waste"],"created_at":"2024-11-14T20:33:10.860Z","updated_at":"2025-04-11T21:45:02.364Z","avatar_url":"https://github.com/tuxuser.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/custom-components/hacs)\n\n# Home Assistant sensor for german waste collection schedule (Jumomind)\n\n## Functionality\n\nThe sensor shows the bin which will be collected the next day. The complete collection schedule is available as attributes of the sensor\n\nSupported services:\n\n* ZAW\n* Aurich\n* Altötting\n* Lübbecke\n* Barnim\n* Minden\n* Rhein-Hunsrück\n* Recklinghausen\n* Uckermark\n* Ingolstadt\n\nNon-working:\n\n* Bad Homburg vdH\n* Hattersheim am Main\n* Groß-Gerau\n\n![alt text](https://github.com/tuxuser/abfallapi_jumomind_ha/blob/master/preview1.png \"glance card\")\n\n![alt text](https://github.com/tuxuser/abfallapi_jumomind_ha/blob/master/preview2.png \"glance card details\")\n\n## Credits\n\nBased on [AWB Köln Home Assistant sensor](https://github.com/jensweimann/awb) by [jensweimann](https://github.com/jensweimann)\n\n## Installation\n\n### Manual\n\nCopy all files from custom_components/abfallapi_jumomind/ to custom_components/abfallapi_jumomind/ inside your config Home Assistant directory.\n\n### HACS\n\nSearch for Abfall API (Jumomind) in HACS -\u003e Integrations. Install the integration and restart home assistant.\n\n\u003c!---\n## Discussion\n\n[Home Assistant Community Forum](https://community.home-assistant.io/t/german-mullabfuhr-sensor/168244)\n--\u003e\n\n## Configuration\n\n### Find service_id, city_id and area_id\n\nTo assemble the matching endpoint, take the value of the SERVICES dictionary in `jumomind_abfall_api.py`.\nExample:\n\n```python\n  SERVICES : {\n    ...\n    'Minden': 'sbm',\n    ...\n  }\n```\n\nEndpoint: sbm\n\n#### service_id\n\nservice_id is the human-readable string found in `jumomind_abfall_api.py` -\u003e SERVICES\n\nExample:\n\n```yaml\nservice_id: Minden\n```\n\n#### city_id\n\n`GET https://\u003cENDPOINT\u003e.jumomind.com/mmapp/api.php?r=cities\u0026city_id=\u0026area_id=`\n\nExample output:\n\n```json\n[\n  {\"name\": \"Alsbach-Hähnlein\", \"_name\": \"Alsbach-Hähnlein\", \"id\": \"87\", \"region_code\": \"05\", \"area_id\": \"0\", \"img\": null, \"has_streets\": true},\n  ...\n]\n```\n\nExample for *Alsbach-Hähnlein*:\n\n```yaml\ncity_id: 87\n```\n\n#### area_id\n\n`GET https://\u003cENDPOINT\u003e.jumomind.com/mmapp/api.php?r=streets\u0026city_id=\u003ccity_id\u003e\u0026area_id=`\n\nExample output:\n\n```json\n[\n {\"name\":\"TANNENWEG\",\"_name\":\"TANNENWEG\",\"id\":\"372409\",\"area_id\":\"089110001\",\"houseNumberFrom\":\"0001\",\"houseNumberTo\":\"0001\",\"comment\":\"\",\"houseNumbers\":[[\"0001\",\"089110001\"],[\"0002\",\"089110002\"],[\"0002A\",\"089110002A\"],[\"0004\",\"089110004\"],[\"0006\",\"089110006\"]]},\n ...\n]\n```\n\nExample for *Tannenweg 1*:\n\n```yaml\narea_id: 089110001\n```\n\nExample for *Tannenweg 2*:\n\n```yaml\narea_id: 089110002\n```\n\n#### (Optional) Filter for trash types\nIf you just want specific types of trash collection to be respected...\n\n`GET https://\u003cENDPOINT\u003e.jumomind.com/mmapp/api.php?r=trash\u0026city_id=\u003ccity_id\u003e\u0026area_id=\u003carea_id\u003e`\n\nExample output for Service ZAW:\n```json\n[\n  {\"title\":\"Biomüll\",\"name\":\"ZAW_BIO\",\"_name\":\"ZAW_BIO\",\"color\":\"06c53c\"},\n  {\"title\":\"Gelber Sack\",\"name\":\"ZAW_GELB\",\"_name\":\"ZAW_GELB\",\"color\":\"dcef08\"},\n  {\"title\":\"Papier Tonnen und Container\",\"name\":\"ZAW_PAP\",\"_name\":\"ZAW_PAP\",\"color\":\"2b52e7\"},\n  {\"title\":\"Restmüll Container wöchentlich\",\"name\":\"ZAW_REST_W\",\"_name\":\"ZAW_REST_W\",\"color\":\"99999\"},\n  {\"title\":\"Restmüll Tonnen und Container 14-täglich\",\"name\":\"ZAW_REST_2W\",\"_name\":\"ZAW_REST_2W\",\"color\":\"717170\"},\n  {\"title\":\"Schadstoffmobil\",\"name\":\"ZAW_SCHAD\",\"_name\":\"ZAW_SCHAD\",\"color\":\"e0483d\"}\n]\n```\n\nConfiguration entry:\n```yaml\ntrash_types:\n  - ZAW_BIO\n  - ZAW_GELB\n  - ZAW_PAP\n  - ZAW_REST_2W\n```\n\n### Setup sensor\n\n```yaml\n- platform: abfallapi_jumomind\n  name: muellabfuhr\n  scan_interval: 3600\n  service_id: Minden\n  city_id: 87\n  area_id: 089110001\n```\n\nOr for ZAW, filtering for specific trash types:\n```yaml\n- platform: abfallapi_jumomind\n  name: muellabfuhr\n  scan_interval: 3600\n  service_id: ZAW\n  city_id: 106\n  area_id: 49\n  trash_types:\n    - ZAW_BIO\n    - ZAW_GELD\n    - ZAW_PAP\n    - ZAW_REST_2W\n```\n\n### Customize\n\n```yaml\nsensor.muellabfuhr:\n  friendly_name: Heute Mülltonne rausstellen\n  icon: mdi:delete\n```\n\n### Automation\n\n```yaml\n- alias: Abfall Notification\n  trigger:\n    - platform: time\n      at: \"18:00:00\"\n    - entity_id: binary_sensor.someone_is_home\n      from: 'off'\n      platform: state\n      to: 'on'\n  condition:\n    - condition: and\n      conditions:\n      - condition: time\n        after: '09:00:00'\n      - condition: time\n        before: '23:00:00'\n      - condition: template\n        value_template: \"{{ (states.sensor.muellabfuhr.state != 'Keine') and (states.sensor.muellabfuhr.state != 'unknown') }}\"\n  action:\n    - service: notify.my_telegram\n      data_template:\n        message: \"{{ states.sensor.muellabfuhr.state }}\"\n```\n\n## DISCLAIMER\n\nThis project is in no way endorsed by or affiliated with Jumomind, or any associated subsidiaries, logos or trademarks.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuxuser%2Fabfallapi_jumomind_ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuxuser%2Fabfallapi_jumomind_ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuxuser%2Fabfallapi_jumomind_ha/lists"}