A Home Assistant custom integration to track consumable items that need periodic replacement, such as filters, pads, cartridges, and other maintenance items.

• Multi-consumable tracking: Track multiple consumables per device (e.g., HVAC system with furnace filter, humidifier pad, and UV bulb)
• Days remaining sensor: Shows how many days until replacement is needed
• Warning thresholds: Configurable warning period before replacement is due
• Dynamic icons: Icons change based on status (normal, warning, overdue)
• Mark as replaced button: One-click button to reset the replacement date
• Date entity: View and manually edit the last replacement date
• State persistence: Maintains tracking data across Home Assistant restarts

1. Open HACS in Home Assistant
2. Search for "Consumable Tracker"
3. Click "Download"
4. Restart Home Assistant

1. Download the consumable_tracker folder from this repository
2. Copy it to your config/custom_components/ directory
3. Restart Home Assistant

1. Go to Settings > Devices & Services
2. Click Add Integration
3. Search for "Consumable Tracker"
4. Enter a device name (e.g., "HVAC System")
5. Add your first consumable:
   • Name: e.g., "Furnace Filter"
   • Lifetime (days): How long the consumable lasts (1-730 days)
   • Warning threshold (days): When to start warning (0-365 days)
   • Icons (optional): Custom icons for normal, warning, and overdue states
6. Optionally add more consumables to the same device
7. Click Submit

After setup, you can add, edit, or delete consumables:

1. Go to Settings > Devices & Services
2. Find your Consumable Tracker device
3. Click Configure
4. Choose to add, edit, or delete consumables

For each consumable, the integration creates three entities:

The sensor includes additional attributes:

• consumable_name: Name of the consumable
• lifetime_days: Configured lifetime
• warning_days: Warning threshold
• last_changed: Date of last replacement
• next_replacement: Calculated next replacement date
• percentage: Percentage of lifetime remaining

• HVAC Systems: Furnace filters, humidifier pads, air intake filters
• Water Filtration: Reverse osmosis filters, UV bulbs, sediment cartridges
• Kitchen Appliances: Refrigerator water filters, coffee maker cartridges
• Medical Equipment: CPAP filters, nebulizer supplies
• Vehicles: Cabin air filters, windshield wipers

This integration includes a blueprint that creates persistent notifications when consumables need attention:

Click the badge above to import, then create an automation from the blueprint for each consumable you want to monitor.

The blueprint will:

• Show a warning notification when days remaining reaches the warning threshold
• Update to an urgent notification when the consumable is fully depleted
• Automatically dismiss the notification when the consumable is replaced

type: entities
title: HVAC Consumables
entities:
  - entity: sensor.hvac_system_furnace_filter_days_remaining
  - entity: button.hvac_system_mark_furnace_filter_as_replaced
  - entity: sensor.hvac_system_humidifier_pad_days_remaining
  - entity: button.hvac_system_mark_humidifier_pad_as_replaced

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.