Skip to content

TrashCard - indicates what type of trash will be picked up next based on your calendar entries πŸ—‘οΈ

License

Notifications You must be signed in to change notification settings

idaho/hassio-trash-card

Repository files navigation

πŸ—‘οΈ TrashCard

GitHub Release License hacs_badge

Project Maintenance GitHub Activity downloads Build

Buy Me A Coffee


new-overview

Never forget garbage collection day again!

TrashCard is a custom Home Assistant card that displays the your current and upcoming trash collection schedule. It uses events contained within the local calendar integration to display the information.

Features

  • Colors, icons and text for residual, organic, paper waste and recycling events.
  • Colors and icons for all custom events.
  • A filter for events.

Pre-Requirements

TrashCard requires:

Once you have both of these installed, you can install TashCard either:

  • Through HACS.
  • Manually.

Installation

HACS

TrashCard is available in HACS (Home Assistant Community Store).

  1. Install HACS if you haven’t already.
  2. Open HACS in Home Assistant.
  3. Go to the "Frontend" section.
  4. Click the "+" icon.
  5. Search for "TrashCard".

Manual

  1. Download the latest latest release of trashcard.js from the GitHub repository.
  2. Add trashcard.js into your config/www folder.

You must then add a reference to trashcard.js in your Dashboard. There are two methods for doing this:

Using the UI:

  • Settings β†’ Dashboards β†’ More Options icon β†’ Resources β†’ Add Resource β†’ Set Url as /local/trashcard.js β†’ Set Resource type as JavaScript Module.

Note: If you do not see the Resources menu, you will need to enable Advanced Mode in your User Profile

Using YAML:

Add following code to the lovelace section in configuration.yaml:

  ```yaml
  resources:
    - url: /local/trashcard.js
      type: module
  ```

Usage

Create events in your calendar

In order for TrashCard to display information, your garbage collection schedule needs to be added in the local calendar. Creating a dedicated β€œGarbage collection” calendar for this purpose is a good way to keep things organised.

image

Note:

  • When adding the dates, the events must be set to β€œFull day”.
  • The event name (in the β€œsummary” field) must be the same name as the type of collection event.
  • Up to five different types of collection events are supported (Garbage, recycling, organic waste etc.).
  • Repeating events are supported.

Configuration

The TrashCard cards can be configured using the Dashboard UI editor.

Add a new card

  1. In the Dashboard UI, select "Edit Dashboard" in top right corner.
  2. Click the "+Add Card" button.
  3. Find the Custom: TrashCard card in the list.
  4. Set the entity to the calendar that contains the collection events.
  5. Configure the display settings of the card using the options.

All the options listed below are available in the lovelace editor, but configuring via yaml is supported too.

Name Type Default Description
entities array of strings Required The calendar(s) containing the collection events.
layout string Optional Layout of the card. Vertical, horizontal and default layouts are supported.
fill_container boolean false Fill container or not. Useful when card is in a grid, vertical or horizontal layout.
filter_events boolean false Filter and display events from the calendar by names (if at least one is defined).
full_size boolean false Show the card without the default card margins.
drop_todayevents_from time 10:00:00 From what time to hide all-day event (Format hh:mm:ss).
use_summary boolean false Shows the event summary instead of matched label.
hide_time_range boolean false Option to hide the time on events that aren't full day events.
event_grouping boolean true Only display the next event per pattern, otherwise all events during the selected time will be displayed.
next_days number 2 How many times the card will look into the future to find the next event.
day_style default or counter default Option for how the date of an event should be displayed. default shows the date in date format and counter shows the number of days remaining before the event.
card_style card, chip or icon card Switch between the events style Standard card, Chip card or a new Icon predefined layout.
alignment_style left, center, right or space left Switch between alignments on Chip card card_style.
color_mode background or icon background Select whether the color settings should be applied to the background or to the icon.
refresh_rate integer 60 Check for changes in the calendar every x minutes. By default it will check every 60 minutes. Values can be set from 5 to 1440.
debug boolean false Option to enable debug mode to help fixing bugs ;) .
icon_size integer 40 Size of the icons in px if you choose card_style as icon .
with_label boolean true Option to display the label in the card or chip style.
pattern array of Pattern Required Pattern to detect the kind of trash and how to display it.

Pattern

Name Type Default Description
type organic, paper, recycle, waste, others, custom Required Label which should be shown.
label string Required The label that will be displayed.
icon string Required The icon that will be displayed.
color string Required The background color of the card.
pattern string Required Pattern used to detect and display an event type. (Is tested against the calendar entry title).
picture string Optional Picture URL do display an image instead of an icon.

Other type trash configuration

Name Type Default Description
icon string Required The icon that will be displayed.
color string Required The background color of the card.

Example calendar events

The red and yellow bins are collected every fortnight on Thursdays. The red and green bins are collected every other fortnight on Thursdays. image

Example TrashCard configuration that displays the events shown above

image

Output of the configuration above, using a custom picture instead of an icon

image

Example YAML configuration

type: custom:trash-card
entities:
  - calendar.mags_abfuhrtermine
layout: vertical
event_grouping: true
drop_todayevents_from: '10:00:00'
next_days: 300
day_style: counter
card_style: card
color_mode: background
items_per_row: 4
refresh_rate: 60
with_label: true
filter_events: false
use_summary: false
hide_time_range: false
pattern:
  - label: Organic
    icon: mdi:flower
    pattern: braun
    color: light-green
    type: organic
  - label: Paper
    icon: mdi:newspaper-variant-multiple-outline
    color: indigo
    pattern: blau
    type: paper
  - label: Recycling
    pattern: gelb
    icon: mdi:recycle-variant
    color: amber
    type: recycle
  - pattern: grau
    icon: mdi:trash-can
    label: Waste
    color: dark-grey
    type: waste
  - icon: mdi:dump-truck
    color: purple
    type: others
  - label: Electric
    icon: mdi:electron-framework
    color: pink
    type: custom
    pattern: elektro

Icons and Layouts

Layout: icons

layout-icons

Layout: chips

layout-chips

Layout: cards

layout-cards

Using pictures instead of icons

with-image