{"id":17002527,"url":"https://github.com/pandermusubi/afvalophaaldata","last_synced_at":"2025-03-23T17:31:17.726Z","repository":{"id":143371082,"uuid":"54645847","full_name":"PanderMusubi/afvalophaaldata","owner":"PanderMusubi","description":"🗑 Kalender met herinnering voor afvalophaaldata in Nederland","archived":false,"fork":false,"pushed_at":"2025-01-14T13:04:58.000Z","size":47573,"stargazers_count":2,"open_issues_count":5,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-18T22:26:55.895Z","etag":null,"topics":[],"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/PanderMusubi.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}},"created_at":"2016-03-24T13:57:30.000Z","updated_at":"2025-01-14T13:05:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"d6115083-a88e-466f-9d5a-1477c3f68407","html_url":"https://github.com/PanderMusubi/afvalophaaldata","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/PanderMusubi%2Fafvalophaaldata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PanderMusubi%2Fafvalophaaldata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PanderMusubi%2Fafvalophaaldata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PanderMusubi%2Fafvalophaaldata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PanderMusubi","download_url":"https://codeload.github.com/PanderMusubi/afvalophaaldata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245140961,"owners_count":20567481,"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":"2024-10-14T04:28:20.700Z","updated_at":"2025-03-23T17:31:17.702Z","avatar_url":"https://github.com/PanderMusubi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Afvalophaaldata\n\n(English documentation is found below.)\n\n\u003e \u003cem\u003eAlles is veranderlijk, niets is zonder verandering.\u003c/em\u003e — Gautama\nSiddhartha (563 – 483 v.Chr.) Hindoeïstische prins en grondlegger van boeddhisme\n\n## 1 Inleiding\n\nIn Nederland kun je met een website of app zien wanneer jouw huisvuil wordt\nopgehaald. Het gebruik van een dergelijke website kan omslachtig zijn en een app\nvereist rechten op je mobiele apparaat die je privacy niet kunnen waarborgen.\nMede hierdoor is ook een beweging om zo min mogelijk propriëtaire (en mogelijk\nschadelijke) apps geïnstalleerd te hebben.\n\nDit project biedt de afvalophaaldata voor jouw adres aan die je kan toevoegen\nals een online kalender op je computer of mobiel apparaat. Deze integratie – die\nook notificaties kan geven – maakt afstemming met andere afspraken makkelijker\nen je hoeft geen vuilnisapp meer op je smartphone of tablet te installeren.\n\nOp deze manier ben je altijd op de hoogte van wijzigingen in de reguliere\nophaaldagen vanjouw afval. Voorbeelden van hiervan zijn feestdagen of bepaalde\nevenementen bij je in de buurt of wanneer er kerstbomen worden opgehaald.\n\n## 2 Indruk\n\nOm een idee te krijgen hoe afvalophaaldata in je kalender eruit ziet, staan\nhieronder twee voorbeelden. De eerste is van op een mobiel apparaat en de tweede\nvan op een computer.\n\n[\u003cimg alt=\"example mobile\" src=\"images/example-etar-cropped.png?raw=true\" width=\"50%\" /\u003e](https://raw.github.com/PanderMusubi/afvalophaaldata/master/images/example-etar-cropped.png)\n\n[![example](images/example-thunderbird-cropped.png?raw=true)](https://raw.github.com/PanderMusubi/afvalophaaldata/master/images/example-thunderbird-cropped.png)\n\n## 3 Gebruik\n\nDe kalenders hier zijn in iCalendar-formaat (.ics) en zijn te gebruiken door\nde volgende drie stappen te volgen:\n1. Indien nodig, installeer een kalendersoftware.\n2. Vind de link van de afvalophaalkalender voor jouw adres.\n3. Voeg deze link toe aan je kalendersoftware.\n\n**Waarschuwing:** Klik **niet** op links van afvalophaalkalenders! Je moet ze\nalleen kopiëren naar kalendersoftware omdat er anders de volgende problemen\nkunnen optreden:\n* Je webbrowser probeert de link te openen maar weet niet wat er mee moet\ngebeuren en geeft een foutmelding.\n* De huidige kalender wordt gedownload, maar verder gebeurd er niets.\n* De huidige kalender wordt eenmalig geïmporteerd, maar updates blijven uit.\n\n### 3.1 Installeer kalendersoftware\n\nWaarschijnlijk heb je al software geïnstalleerd om online kalenders te gebruiken. Mocht dat niet het geval zijn, afvalophaalkalenders zijn weer te geven met:\n\n| Naam              | Android | iOS | macOS | Windows | Linux | Web |\n|-------------------|:-------:|:---:|:-----:|:-------:|:-----:|:---:|\n| Google Calendar   | [✔](https://play.google.com/store/apps/details?id=com.google.android.calendar) | [✔](https://apps.apple.com/app/google-calendar-get-organized/id909319292) | - | - | - | [✔](https://google.com/calendar) |\n| ICSx⁵             | [✔](https://play.google.com/store/apps/details?id=at.bitfire.icsdroid) | - | - | - | - | - |\n| Thunderbird       | [✔](https://play.google.com/store/apps/details?id=net.thunderbird.android) | - | [✔](https://www.thunderbird.net) | [✔](https://www.thunderbird.net) | [✔](https://www.thunderbird.net) | - |\n| NextCloud         | [✔](https://play.google.com/store/apps/details?id=com.nextcloud.client) | [✔](https://apps.apple.com/us/app/nextcloud/id1125420102) | ✔ | ✔ | ✔ | ✔ |\n| Apple Calendar    | - | ✔ | ✔ | - | - | [✔](https://www.apple.com/icloud/#ccm) |\n| Microsoft Outlook | [✔](https://play.google.com/store/apps/details?id=com.microsoft.office.outlook) | [✔](https://www.apple.com/search/outlook) | [✔](https://www.apple.com/search/outlook) | [✔](https://products.office.com/outlook) | - | [✔](https://outlook.com) |\n\nICSx⁵ is ook te vinden in de [F-Droid](https://f-droid.org/repository/browse/?fdfilter=calendar\u0026fdid=at.bitfire.icsdroid) appstore. Gebruik **geen** software die alleen maar ICS-bestanden kan importeren.\n\n### 3.2 Vind de link voor jouw adres\n\nIn de map genaamd [ics](ics) zijn de kalenders te vinden. Voor elke postcode is\ner een bestand README.md met een overzicht van alle kalenders. Dit is de meest\nmakkelijke manier om een specifieke kalender te vinden en toe te voegen aan\nkalendersoftware.\n\nDe links van de kalenders hebben de volgende opbouw:\n1. `https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/`\n2. `DDDD/` (decimalen van de postcode, bijvoorbeeld `3531`)\n3. `LL/` (letters van de postcode, bijvoorbeeld `EB`)\n4. `N` (decimalen van het huisnummer, bijvoorbeeld `2`)\n5. `-EEE` (optionele huisnummertoevoeging, bijvoorbeeld `BSA` of `BS`)\n6. `_HHMM` (optionele notificatie, `_2130` avond ervoor, `_0700` in de ochtend)\n7. `.ics`\n\nAlleen bovenstaande twee specifieke notificaties zijn beschikbaar. Voorbeelden\nvan links zijn:\n* voor postcode `3531 EB` op huisnummer `2` zonder notificatie\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2.ics`\n* voor postcode `3531 EB` op huisnummer `2` met een notificatie in de ochtend om 07.00\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2_0700.ics`\n* voor postcode `3531 EB` op huisnummer `2` met een notificatie de avond ervoor om 21.30\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2_2130.ics`\n* voor postcode `3531 EB` op huisnummer `2` toevoeging `BS` met een notificatie de avond ervoor om 21.30\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2-BS_2130.ics`\n* voor postcode `3531 EB` op huisnummer `2` toevoeging `BSA` met een notificatie de avond ervoor om 21.30\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2-BSA_2130.ics`\n\nAls je postcode er niet bijstaat, dien een verzoek in via een\n[issue](https://github.com/PanderMusubi/afvalophaaldata/issues) maar om\nprivacyredenen, noem alleen je postcode en **niet** je huisnummer. Indien\nmogelijk, voeg ook de website toe van de organisatie waar jouw afvalophaaldata\nzijn te vinden. Daarna worden er kalenders voor je gemaakt voor alle huisnummers\nmet die postcode.\n\n### 3.3 Voeg jouw link toe aan kalendersoftware\n\nNadat je jouw link hebt gekopieerd, plak deze bij in jouw kalendersoftware bij\nhet aanmaken van een (alleen-lezen) online netwerk- of ICS-kalender. Soms heet\ndit abonneren (*suscribe)* op een kalender. Meestal kun je dan ook instellen\nwanneer synchronisatie moet plaatsvinden zodat je afvalophaalkalender up to date\nblijft. Zet deze op 24 uur want er zij niet zoveel updates. Nogmaals, kies\n**niet** voor het (eenmalig) importeren van een ICS-kalender want die zal\nzichzelf niet updaten.\n\n## 4 Onderhoud\n\n### 4.1 Postcodes en huisnummers\n\nNederlandse postcodes zijn te vinden op https://www.postcode.nl . Gebruik geen\nhuisnummers zonder een woonfuctie. Huisnummers met alleen een bestemming\nbijeenkomstfunctie, industriefunctie en/of winkelfunctie worden hier niet\nondersteunt omdat die een commerciële afvalophaaldienst moeten gebruiken.\n\n### 4.2 Notificaties in Thunderbird\n\nIn Thunderbird is een bug met notificaties voor alleen-lezen kalenders. Stem of\nvoeg zinvol commentaar toe voor de volgende gerelateerde bugs:\n* https://bugzilla.mozilla.org/show_bug.cgi?id=375209\n* https://bugzilla.mozilla.org/show_bug.cgi?id=496889\n* https://bugzilla.mozilla.org/show_bug.cgi?id=702206\n* https://bugzilla.mozilla.org/show_bug.cgi?id=861594\n\nAls dit gebeurd, de workaround voor Thunderbird is om te gaan naar\n`Preferences / Calendar / Reminders` en `Show missed reminders` uit te zetten.\n\n\u003c!--###4.3 Validatie\n\nKalender die zijn aangemaakt kunnen gevalideerd worden met:\n* [postcode en huisnummer](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3524%2FDZ%2F172.ics)\n* [postcode, huisnummer en toevoeging](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3521%2FVX%2F90-BS.ics)\n* [postcode, huisnummer en notificatie](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3521%2FEC%2F17_0700.ics)\n* [postcode, huisnummer en notificatie de avond ervoor](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3521%2FEC%2F17_2130.ics)--\u003e\n\n## 5 Zie ook\n\nZie ook de volgende online kalenders:\n* https://github.com/PanderMusubi/lunar-phase-calendar\n* https://github.com/PanderMusubi/dutch-holidays\n\nVoor Androidgebruikers, zie ook de alternatieve kalenderapp Etar in de appstores [Google Play](https://play.google.com/store/apps/details?id=ws.xsoh.etar) en [F-Droid](https://f-droid.org/repository/browse/?fdid=ws.xsoh.etar).\n\n## 6 Licentie\n\nDeze software voor het maken van deze online kalenders met afvalophaaldata en\nbijbehorende handleiding hebben een [MIT](LICENSE)-licentie en zijn mede\nmogelijk gemaakt door de analytische vaardigheden van\n[Hellebaard](http://hellebaard.nl).\n\n# Garbage Collection Dates\n\n(Nederlandse documentatie is hierboven te vinden.)\n\n\u003e \u003cem\u003eEverything changes, nothing remains without change.\u003c/em\u003e — Gautama\nSiddhartha (563 – 483 BC) Hindu prince and founder of Buddhism\n\n## 1 Introduction\n\nIn the Netherlands, you can use a website or app to see when your garbage will\nbe collected at your house. The use of such website can be time-consuming and an\napp demands rights on your mobile device which cannot guarantee your privacy.\nPartly because of this, there is also a movement to install as less of these\npropietary (and potentially harmful) apps as possible.\n\nThis project offers garbage collection data for your address which you can add\nas an online calendar on your computer or mobile device. This integration –\nwhich also supports alarms/notifications – improves the coordination with other\nappointments and you do not have to install a garbage app on your smartphone or\ntablet.\n\nIn this way, you are always up to date of changes to the schedule of regular\ncollection days days of your garbage. Examples of this are public holidays or\nevents in your neighbourhood or when Christmas trees are being collected.\n\n## 2 Impression\n\nTo get an idea how gabarge collection dates look like, below are two examples.\nThe first of on a mobile device and the second on a computer.\n\n[\u003cimg alt=\"example mobile\" src=\"images/example-etar-cropped.png?raw=true\" width=\"50%\" /\u003e](https://raw.github.com/PanderMusubi/afvalophaaldata/master/images/example-etar-cropped.png)\n\n[![example](images/example-thunderbird-cropped.png?raw=true)](https://raw.github.com/PanderMusubi/afvalophaaldata/master/images/example-thunderbird-cropped.png)\n\n## 3 Usage\n\nThe calendars here are in iCalendar format (.ics) and can be used by following\nnext three steps:\n1. If needed, install calendar software.\n2. Find the link for the garbage collection calendar for your address.\n3. Add this link to your calendar software.\n\n**Warning:** Do **not** click on links of your garbage collection calendar! Only\ncopy these to calendar software, because otherwise the following problems can\narise:\n* Your web browser does not know what to with it and give an error message.\n* Your calendar will be downloaded, but nothing will happen next.\n* Your calendar will be imported once, but updates will not take place.\n\nAgain, do not click on a calendar link, only copy the link as text!\n\n### 3.1 Install calendar software\n\nProbably, you already have software installed for using online calendars. If that is not the case, lunar phase calendars can be shown with:\n\n| Name              | Android | iOS | macOS | Windows | Linux | Web |\n|-------------------|:-------:|:---:|:-----:|:-------:|:-----:|:---:|\n| Google Calendar   | [✔](https://play.google.com/store/apps/details?id=com.google.android.calendar) | [✔](https://apps.apple.com/app/google-calendar-get-organized/id909319292) | - | - | - | [✔](https://google.com/calendar) |\n| ICSx⁵             | [✔](https://play.google.com/store/apps/details?id=at.bitfire.icsdroid) | - | - | - | - | - |\n| Thunderbird       | [✔](https://play.google.com/store/apps/details?id=net.thunderbird.android) | - | [✔](https://www.thunderbird.net) | [✔](https://www.thunderbird.net) | [✔](https://www.thunderbird.net) | - |\n| NextCloud         | [✔](https://play.google.com/store/apps/details?id=com.nextcloud.client) | [✔](https://apps.apple.com/us/app/nextcloud/id1125420102) | ✔ | ✔ | ✔ | ✔ |\n| Apple Calendar    | - | ✔ | ✔ | - | - | [✔](https://www.apple.com/icloud/#ccm) |\n| Microsoft Outlook | [✔](https://play.google.com/store/apps/details?id=com.microsoft.office.outlook) | [✔](https://www.apple.com/search/outlook) | [✔](https://www.apple.com/search/outlook) | [✔](https://products.office.com/outlook) | - | [✔](https://outlook.com) |\n\nICSx⁵ can also be found in the [F-Droid](https://f-droid.org/repository/browse/?fdfilter=calendar\u0026fdid=at.bitfire.icsdroid) app store. Do **not** use software that can only import ICS files.\n\n### 3.2 Find the link for your address\n\nSee the directory [ics](ics) for available calendars. For every postcode, there\nis a file called README.md with an overview of the calendars for that postcode.\nThis is the moest easy way to find your calendar.\n\nThe links to the calendars have the following structure:\n1. `https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/`\n2. `DDDD/` (decimals from postcode, e.g. `3531`)\n3. `LL/` (letters from postcode, e.g. `EB`)\n4. `N` (decimals from house number, e.g. `2`)\n5. `-EEE` (optional house number extension, e.g. `BSA` or `BS`)\n6. `_HHMM` (optional notification, `2130` evening before, `0700` for morning)\n7. `.ics`\n\nNote that only two exact notifications are available. The above results in \nhe following examples:\n* for postcode `3531 EB` at house number `2` without a notification\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2.ics`\n* for postcode `3531 EB` at house number `2` with a notification in the morning at 07:00\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2_0700.ics`\n* for postcode `3531 EB` at house number `2` with a notification evening before at 21:30\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2_2130.ics`\n* for postcode `3531 EB` at house number `2` extension `BS` with a notification evening before at 21:30\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2-BS_2130.ics`\n* for postcode `3531 EB` at house number `2` extension `BSA` with a notification evening before at 21:30\u003cbr /\u003e`https://raw.github.com/PanderMusubi/afvalophaaldata/master/ics/3531/EB/2-BSA_2130.ics`\n\nIf your postcode is missing, please request it via an\n[issue](https://github.com/PanderMusubi/afvalophaaldata/issues) but for privacy\nreasons list **only** your postcode and not any house numbers. If possible, also\nadd the website where your garbage collection data can be found. Then calendars\nwill be added for you for all house numbers of that postcode.\n\n### 3.3 Add your link to calendar software\n\nAfter you have copied your link, please paste this in your calendar software\nwhen adding a (read-only) online network or ICS calendar. Sometimes this is\ncalled to subscribe to a calendar. Usually you can choose how often\nsynchronization has to be done to keep your garbage collection calendar up to\ndate. Set this to 24 hours, because there are not that many updates. Again, do\n**not** choose the (one time) import of the ICS calender as it will not update\nitself. \n\n## 4 Maintenance\n\n### 4.1 Postcodes and house numbers\n\nDutch postcodes can be found with https://www.postcode.nl . Do not use house\nnumbers without a residence (*woonfunctie*) designation. House numbers with only\na designation of *bijeenkomstfunctie*, *industriefunctie* and/or *winkelfunctie*\nwill not be supported for garbage collection as these need to use a commercial\ngarbage collection service.\n\n### 4.2 Notifications in Thunderbird\n\nIn Thunderbird is a bug with notifications for read-only calendars. Please vote\nor add a useful comment for the following related bugs:\n* https://bugzilla.mozilla.org/show_bug.cgi?id=375209\n* https://bugzilla.mozilla.org/show_bug.cgi?id=496889\n* https://bugzilla.mozilla.org/show_bug.cgi?id=702206\n* https://bugzilla.mozilla.org/show_bug.cgi?id=861594\n\nIf this bug occurs, the workaround for Thunderbird is to go to\n`Preferences / Calendar / Reminders` and disable `Show missed reminders`.\n\n\u003c!--### 4.3 Validation\n\nCalendars that have been generated can be validated by:\n* [postcode and number](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3524%2FDZ%2F172.ics)\n* [postcode, number and extension](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3521%2FVX%2F90-BS.ics)\n* [postcode, number and notification in the morning](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3521%2FEC%2F17_0700.ics)\n* [postcode, number and notification in the evening before](http://severinghaus.org/projects/icv/?url=https%3A%2F%2Fraw.github.com%2FPanderMusubi%2Fafvalophaaldata%2Fmaster%2Fics%2F3521%2FEC%2F17_2130.ics)--\u003e\n\n## 5 See also\n\nPlease, see also these other online calendars:\n* https://github.com/PanderMusubi/lunar-phase-calendar\n* https://github.com/PanderMusubi/dutch-holidays\n\nFor Android users, see also the alternative calendar app Etar from [Google Play](https://play.google.com/store/apps/details?id=ws.xsoh.etar) or [F-Droid](https://f-droid.org/repository/browse/?fdid=ws.xsoh.etar).\n\n## 6 License\n\nThe software for making these online calendars with garbage collection dates and\naccompanying manual have an [MIT](LICENSE) license and have been made possible\nwith the analytic skills of [Hellebaard](http://hellebaard.nl).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpandermusubi%2Fafvalophaaldata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpandermusubi%2Fafvalophaaldata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpandermusubi%2Fafvalophaaldata/lists"}