About
WhenHub is a Home Assistant integration that tracks trips, one-time dates, yearly events and holidays with countdowns. It supports four event types: multi-day trips, one-time milestones, yearly anniversaries, and special events such as Christmas, Easter, daylight saving changes or custom patterns. Each event gets sensors for days until or since a date, binary sensors such as trip active today, and an image entity, and events also appear in a combined calendar. A date can come from a fixed value or from another date or timestamp entity, and an event can carry an image, a link and a Markdown memo. Events can notify through Repairs when they expire, and actions let automations create, update or delete events. It works locally and is set up in the UI.
Automatic summary of the README and code of moerk-o/WhenHub. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Choose WhenHub event type
- Event type
Set up trip
- Start dateThe date when the trip begins
- Use an HA entity as start date sourceUse a date or timestamp entity instead of the field above
- End dateThe date when the trip ends
- Use an HA entity as end date sourceUse a date or timestamp entity instead of the field above
- Upload image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/trip.jpg — upload above takes priority
- URL (optional)Link to a website, booking page or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
- Notify when expiredCreate a notification in HA Repairs when this event expires
Select start date entity
- Start date entityDate or timestamp entity
Select end date entity
- End date entityDate or timestamp entity
Set up milestone
- Target dateThe date of the important event
- Use an HA entity as date sourceUse a date or timestamp entity instead of the field above
- Upload image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/milestone.jpg — upload above takes priority
- URL (optional)Link to a website or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
- Notify when expiredCreate a notification in HA Repairs when this event expires
Select date entity
- Date entityDate or timestamp entity
Also asked when at the select date entity step.
Set up anniversary
- Original dateThe original date (will repeat yearly)
- Use an HA entity as date sourceUse a date or timestamp entity instead of the field above
- Upload image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/anniversary.jpg — upload above takes priority
- URL (optional)Link to a website or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
After setup
- Use an HA entity as start date sourceUse a date or timestamp entity instead of the date field
- Use an HA entity as end date sourceUse a date or timestamp entity instead of the date field
- Upload new image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/trip.jpg — upload above takes priority
- Remove current image
- URL (optional)Link to a website, booking page or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
- Notify when expiredCreate a notification in HA Repairs when this event expires
- Start date entityEntity with device_class 'date' or 'timestamp'
- End date entityEntity with device_class 'date' or 'timestamp'
- Use an HA entity as date sourceUse a date or timestamp entity instead of the date field
- Upload new image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/milestone.jpg — upload above takes priority
- Remove current image
- URL (optional)Link to a website or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
- Notify when expiredCreate a notification in HA Repairs when this event expires
- Date entityEntity with device_class 'date' or 'timestamp'
- Use an HA entity as date sourceUse a date or timestamp entity instead of the date field
- Upload new image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/anniversary.jpg — upload above takes priority
- Remove current image
- URL (optional)Link to a website or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
- Date entityEntity with device_class 'date' or 'timestamp'
- Upload new image (optional)Drag & drop or click to select a JPEG, PNG, WebP or GIF file
- Or enter image path (optional)Path to an image, e.g. /local/images/special.jpg — upload above takes priority
- Remove current image
- URL (optional)Link to a website or any related URL
- Memo (optional)Free-text notes about this event — supports Markdown
Texts from the code of moerk-o/WhenHub.
Entities
- Binary sensorsTrip starts today, Trip active today, Trip ends today, Is today, Daylight Saving Time active
- ImagesEvent image
- SensorsDays until start, Days until end, Event date, Trip days remaining, Trip percent remaining, Days until next, Days since last, Occurrences count, Occurrence count, Next date, Last date, URL, and 1 more
Actions
- Create eventCreates a WhenHub event. Custom pattern events can only be created in the user interface.Fields: Event type, Name, Rename on conflict, Start date, End date, Date, Start date entity, End date entity, Date entity, Holiday
- Update eventChanges fields of an existing WhenHub event and reloads it. Only the fields you pass are changed.Fields: Event, Name, Replace entity source, Start date, End date, Date, Start date entity, End date entity, Date entity, Holiday
- Delete eventRemoves a WhenHub event including its device and all its entities. There is no confirmation and no undo.Fields: Event
From the README
A Home Assistant integration for tracking various events and important dates. WhenHub provides countdown sensors, status information, and visual representations for your events.
Shows in Vulpo
Calendar card, Chart card, Apple Watch.Information
- Installs
- 52 sharing analytics
- GitHub stars
- 10
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v3.0.0,
- Category
- Productivity and information, Calendars and to-dos
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
whenhub- Issues
- Report an issue











