{"id":20341059,"url":"https://github.com/bouni/abfallplus","last_synced_at":"2025-05-08T02:31:57.172Z","repository":{"id":40687114,"uuid":"259900367","full_name":"Bouni/abfallplus","owner":"Bouni","description":"AbfallPlus component for Home Assistant ","archived":false,"fork":false,"pushed_at":"2023-12-06T14:43:35.000Z","size":52,"stargazers_count":13,"open_issues_count":3,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-05-01T22:11:01.313Z","etag":null,"topics":["abfallplus","hacs","homeassistant","integration"],"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/Bouni.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}},"created_at":"2020-04-29T10:56:49.000Z","updated_at":"2024-01-06T23:59:09.000Z","dependencies_parsed_at":"2023-12-06T15:46:59.587Z","dependency_job_id":null,"html_url":"https://github.com/Bouni/abfallplus","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bouni%2Fabfallplus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bouni%2Fabfallplus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bouni%2Fabfallplus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bouni%2Fabfallplus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bouni","download_url":"https://codeload.github.com/Bouni/abfallplus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224693765,"owners_count":17354082,"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":["abfallplus","hacs","homeassistant","integration"],"created_at":"2024-11-14T21:25:29.256Z","updated_at":"2025-05-08T02:31:57.157Z","avatar_url":"https://github.com/Bouni.png","language":"Python","funding_links":["https://ko-fi.com/I3I364QTM","https://www.buymeacoffee.com/bouni","https://github.com/sponsors/Bouni"],"categories":[],"sub_categories":[],"readme":"# AbfallPlus\n\n----\n\n\u003e [!WARNING]  \n\u003e This integration is no longer maintained!\n\u003e \n\u003e I highly recommentd to use [Waste Collection Schedule](https://github.com/mampfes/hacs_waste_collection_schedule) in combination with [TrashCard](https://github.com/idaho/hassio-trash-card).\n\n----\n\n[![Validate with hassfest](https://github.com/Bouni/abfallplus/actions/workflows/hassfest.yml/badge.svg)](https://github.com/Bouni/abfallplus/actions/workflows/hassfest.yml)\n[![Validate with HACS Action](https://github.com/Bouni/abfallplus/actions/workflows/hacs.yml/badge.svg)](https://github.com/Bouni/abfallplus/actions/workflows/hacs.yml)\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)\n\n\u003ca href=\"https://ko-fi.com/I3I364QTM\" target=\"_blank\"\u003e\u003cimg src=\"https://ko-fi.com/img/githubbutton_sm.svg\" height=\"30px\"/\u003e\u003c/a\u003e \u003ca href=\"https://www.buymeacoffee.com/bouni\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" height=\"30px\"/\u003e\u003c/a\u003e \u003ca href=\"https://github.com/sponsors/Bouni\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/-Github Sponsor-fafbfc?style=flat\u0026logo=GitHub%20Sponsors\" height=\"30px\"/\u003e\u003c/a\u003e\n\nThis component has been created to be used with Home Assistant.\n\nAbfallPlus allows you to get upcoming municipal waste pick up dates into Home Assistant.\n\n## Data source\n\nThe data is fetched from `https://api.abfallplus.de`\n\n### Installation:\n\n#### HACS\n\n- Ensure that HACS is installed.\n- Search for and install the \"AbfallPlus\" integration.\n- Restart Home Assistant.\n\n#### Manual installation\n\n- Download the latest release.\n- Unpack the release and copy the custom_components/abfallplus directory into the custom_components directory of your Home Assistant installation.\n- Restart Home Assistant.\n\n### Example entry for configuration.yaml\n\n```\n- platform: abfallplus\n  name: Bio Tonne\n  key: 5b0384147b5bc055c30fee1fb6db6f76\n  municipality: 270\n  street: 15720\n  trash_ids: \"51, 17, 48, 31, 43, 20, 321\"\n  pattern: Biotonne\n```\n\n - `name` is optional, this defines the friendly name of the sensor\n - `key` is required, the API key of the waste management agency (see details below)\n - `municipality` is required, the ID of the municipality (see details below)\n - `street` is required, the ID of the street (see details below)\n - `trash_ids` is required, the IDs of the trash IDs you want to receive (see details below)\n - `pattern` is optional, filter waste types depending on this keyword \n\nThis gives you a `sensor` in Home-Assiatnt that's called `sensor.bio_tonne` which has the next collection date as it's state:\n\n![image](https://user-images.githubusercontent.com/948965/155665244-52ab32bd-c6a8-45ab-b1fd-cd4ad402bd46.png)\n\n### How to get all the IDs\n\nHere we come to the Problem of this Integration. AbfallPlus does not have a open documented API but we use the API calls that are made by the waste management agency.\nI describe by the example of my waste management agency how to get all the IDs and the API key.\nThe IDs seem to be the database indices and are kind of arbitrary.\n\n#### The waste management agency key\n\nGo the the website of your waste management agency, `https://www.abfall-landkreis-waldshut.de/de/termine/abfuhrtage.php` in my case.\nOpen the Developer tools of your browser select the networking tab and refresh the page.\n\nYou should see at least one call to `api.abfallplus.de`, in my case `https://api.abfallplus.de/index.php?key=5b0384147b5bc055c30fee1fb6db6f76`\nAs you can see, the key is passed as an GET parameter.\n\n#### The IDs\n\nUsually you have a dropdown on the page that lets you select your municipality. \nIf thats done there is another pull down that lets you select your street.\n\nAfter all selections are made, there is a dropdown that allows you to select between various output formats such as PDF, CSV or ICS.\nIt doesn't matter which one you select, just click the export button.\n\nYou should see a POST request that hast several form values as parameters, here's mine for example:\n\n```\n\"f_id_kommune\":\"270\",\n\"f_id_strasse\":\"15720\",\n\"f_id_abfalltyp_0\":\"51\",\n\"f_id_abfalltyp_1\":\"17\",\n\"f_id_abfalltyp_2\":\"48\",\n\"f_id_abfalltyp_3\":\"31\",\n\"f_id_abfalltyp_4\":\"43\",\n\"f_id_abfalltyp_5\":\"20\",\n\"f_id_abfalltyp_6\":\"321\",\n\"f_abfallarten_index_max\":\"7\",\n\"f_abfallarten\":\"51,17,48,31,43,20,321\",\n\"f_zeitraum\":\"20200101-20201231\",\n\"f_export_als\":\"{'action':'https://api.abfallplus.de/?key=5b0384147b5bc055c30fee1fb6db6f76\u0026modus=d6c5855a62cf32a4dadbc2831f0f295f\u0026waction=export_ics','target':''}\"\n```\n\n - `f_id_kommune` is your value for municipality\n - `f_id_strasse` is your street\n - `f_abfallarten` is your trash_ids value\n\n❗ In some cases you'll get something like this where `f_id_strasse` is not a number:\n\n```\n\"f_id_kommune\": \"2593\",\n\"f_id_bezirk\": \"492,493\",\n\"f_id_strasse\": \"2593bauernschaften\",\n\"f_id_strasse_hnr\": \"496\"\n```\nIn that case you can use `f_id_strasse_hnr` for the `street` config value!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbouni%2Fabfallplus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbouni%2Fabfallplus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbouni%2Fabfallplus/lists"}