Waste Collection Schedule

Waste Collection Schedule is a custom Home Assistant component designed to retrieve waste collection schedules from various service providers. It supports schedules updated daily from provider websites, local ICS/iCal files, or user-defined date patterns.

Key features include:

• Automatic Calendar Integration: Populates the Home Assistant built-in Calendar with schedules.
• Flexible Display: High flexibility in formatting and displaying information via entity cards or pop-ups.
• Extensible Framework: Designed to be easily extended to support new service providers or other schedule-based services.

Capabilities

• No account required: Uses WM's public guest lookup; no MyWM account is needed.
• Municipal/Franchise support: Works for addresses where the township contracts with WM.
• Comprehensive service coverage: Automatically returns all active services (Trash, recycling, yard waste, etc.).
• Holiday awareness: Reflects adjusted pickup dates caused by holidays.

Troubleshooting

• API Key Rotation: WM's internal API keys are embedded in their web app and may rotate. If the integration stops working, it is likely due to a key rotation. Please report this by opening an issue in the repository.

The project supports various waste collection service providers across multiple countries. You can find specific documentation and source files for each provider organized by country.

Supported countries include:

• Japan
• Liechtenstein
• Lithuania
• Luxembourg
• Malta
• Netherlands
• New Zealand
• Norway
• Poland (and others in subsequent segments)

Each entry in the documentation typically links to a specific source file (e.g., /doc/source/...) and identifies the provider's official website URL.

The project supports a wide range of waste collection service providers across multiple countries, including Poland, Portugal, Slovakia, Slovenia, South Africa, and Sweden. Each provider is associated with specific documentation and a source URL.

To find information for a specific municipality or provider, refer to the documentation files listed in the README. For example, many Polish municipalities use the sisms.pl service, while others use smiecioplan.pl, kiedyodpady.pl, or custom local APIs.

When configuring an impactapps_com_au source, you can identify the property in two ways:

1. Using property_id: An integer that can be found by inspecting network traffic when using the council's website to find the schedule.
2. Using address components: Provide suburb (string), street_name (string), and street_number (string). These must exactly match the address information available via the council's website calendar.

Note: You should use one method or the other; do not mix them if you want predictable results.

The multiple source is a wrapper used to include multiple different waste collection sources within a single calendar entity.

When to use it: Use this wrapper when you want all collected dates to appear in one single calendar. If you prefer to have separate calendar entities for different sources, do not use this wrapper; instead, pass multiple source objects directly to the top-level sources parameter in your configuration.

Note on configuration syntax: When defining multiple sources of the same type (e.g., two ics sources), you cannot use the same key twice in a dictionary. Instead, you must use the list syntax for that key.

waste_collection_schedule:
  sources:
    - name: multiple
      args:
        SOURCE_NAME: SOURCE_ARGS
        SOURCE_NAME: 
          - SOURCE_ARGS_1
          - SOURCE_ARGS_2

The marysville_wa_us source retrieves Garbage Collection events from the city's ArcGIS feature service based on day-of-week schedules.

• Weekly pickup: Returns an entry every week.
• Monthly pickup: Returns an entry every four weeks. Note that the underlying database does not specify which specific week of the month the pickup occurs.