How bannon52/sourdough_bulk_fermenter works
This Home Assistant integration configures temperature and optional humidity inputs, estimates bulk fermentation from a Q10 model and editable recipe, and exposes live sensors and timer controls. The runtime coordinator owns condition reads, recalculation, accumulated progress, and notifications; entity platforms publish and mutate that shared state. A bundled Lovelace card presents the outputs and controls. Edges are limited to calls and relationships shown in excerpts or documented in the README; unsampled sensor and configuration wiring is not inferred.
Main entry points: coordinator.py Shared runtime coordinator · sourdough-card.js Fermentation dashboard card · sensor.py Countdown sensors · number.py Recipe number controls
Components 13
Setup and Configuration
- Setup and options flow
custom_components/sourdough_ferment/config_flow.py - Integration setup
custom_components/sourdough_ferment/__init__.py - Defaults and signals
custom_components/sourdough_ferment/const.py
Fermentation Runtime
- Shared runtime coordinator
custom_components/sourdough_ferment/coordinator.py - Fermentation model
custom_components/sourdough_ferment/calc.py
Home Assistant Entities
- Estimate and recipe sensors
custom_components/sourdough_ferment/sensor.py - Countdown sensors
custom_components/sourdough_ferment/sensor.py - Recipe number controls
custom_components/sourdough_ferment/number.py - Start and reset buttons
custom_components/sourdough_ferment/button.py
Dashboard Card
- Fermentation dashboard card
custom_components/sourdough_ferment/www/sourdough-card.js
Other components
- Home Assistant user
- Temperature and humidity sensors
- Notify services
Connections 17
- Home Assistant user → Setup and options flow: configures integration
README.md - Integration setup → Shared runtime coordinator: creates coordinator
custom_components/sourdough_ferment/__init__.py - Integration setup → Fermentation dashboard card: registers frontend
custom_components/sourdough_ferment/__init__.py - Shared runtime coordinator → Temperature and humidity sensors: reads conditions
custom_components/sourdough_ferment/coordinator.py - Shared runtime coordinator → Fermentation model: calculates estimate
custom_components/sourdough_ferment/coordinator.py - Estimate and recipe sensors → Shared runtime coordinator: reads runtime state
custom_components/sourdough_ferment/sensor.py - Countdown sensors → Shared runtime coordinator: reads countdown
custom_components/sourdough_ferment/sensor.py - Recipe number controls → Shared runtime coordinator: updates recipe
custom_components/sourdough_ferment/number.py - Start and reset buttons → Shared runtime coordinator: starts or resets
custom_components/sourdough_ferment/button.py - Shared runtime coordinator → Notify services: sends alerts
custom_components/sourdough_ferment/coordinator.py - Home Assistant user → Recipe number controls: edits recipe
README.md - Home Assistant user → Start and reset buttons: controls timer
README.md - Fermentation dashboard card → Recipe number controls: sets recipe values
README.md - Fermentation dashboard card → Start and reset buttons: fires timer controls
README.md - Fermentation dashboard card → Estimate and recipe sensors: displays estimates
README.md - Fermentation dashboard card → Countdown sensors: displays progress
README.md - Shared runtime coordinator → Countdown sensors: publishes countdown
README.md