About
WashData monitors appliances through a smart plug, detecting cycles and estimating the time remaining. It reads the power trace to find cycle start, pause and end, then recognises the program once profiles have been taught from recorded or labelled cycles. It supports washing machines, dryers, dishwashers, air fryers, bread makers and pumps, plus a threshold type for simple on/off detection. Entities cover running state, program, progress, current phase, match confidence and time remaining, along with buttons to pause, resume, force-end or record a cycle. Actions let profiles and cycles be labelled, trimmed, exported and imported, and cycle feedback can correct a detected program. It runs locally inside Home Assistant and is set up in the UI by choosing a power sensor and a minimum power threshold.
Automatic summary of the README and code of 3dg1luk43/ha_washdata. 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
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
WashData Setup
- Device NameA friendly name for this device (e.g., 'Washing Machine', 'Dishwasher').
- Device TypeSets detection defaults for this kind of appliance.
- Power SensorThe smart plug sensor that reports live power in watts.
- Minimum Power Threshold (W)Readings above this (in watts) mean the appliance is running. 2 W suits most devices.
Reconfigure WashData
- Device Name
- Device Type
- Power Sensor
- Minimum Power Threshold (W)
After setup
- Device Name
- Device Type
- Power Sensor
- Minimum Power Threshold (W)
Texts from the code of 3dg1luk43/ha_washdata.
Entities
- Binary sensorsRunning, Match Ambiguity, Maintenance due
- ButtonsForce End Cycle, Pause Cycle, Resume Cycle, Record Cycle Start, Record Cycle Stop, Mark Unloaded
- SelectsCycle Program
- SensorsState, Program, Time Remaining, Total Duration, Progress, Current Power, Elapsed Time, Debug Info, Match Confidence, Top Candidates, Ambiguity Score, Current Phase, and 4 more
Actions
- Label CycleAssign an existing profile to a past cycle, or remove the label.Fields: Device, Cycle ID, Profile Name
- Create ProfileCreate a new profile (standalone or based on a reference cycle).Fields: Device, Profile Name, Reference Cycle ID
- Delete ProfileDelete a profile and optionally unlabel cycles using it.Fields: Device, Profile Name, Unlabel Cycles
- Auto-Label Old CyclesRetroactively label unlabeled cycles using profile matching.Fields: Device, Confidence Threshold
- Export ConfigExport this device's profiles, cycles and settings to a JSON file.Fields: Device, Path
- Import ConfigImport profiles, cycles, and settings for this device from a JSON export file (settings may be overwritten).Fields: Device, Path
- Submit Cycle FeedbackConfirm or correct the detected program of a finished cycle. Give device_id (recommended) or entry_id.Fields: Device, Entry ID, Cycle ID, Confirm Detected Program, Corrected Profile, Corrected Duration (seconds), Notes
- Record Cycle StartStart manually recording a clean cycle (bypasses all matching logic).Fields: Device
- Record Cycle StopStop manual recording.Fields: Device
- Trim CycleTrim the power data of a past cycle to a specific time window.Fields: Device, Cycle ID, Trim Start (seconds), Trim End (seconds)
- Pause CyclePause the active cycle for a WashData device.Fields: Device
- Resume CycleResume a paused cycle for a WashData device.Fields: Device
- Trigger ML TrainingManually retrain the on-device ML models from this device's own labelled cycles (experimental).Fields: Device
- Mark UnloadedConfirm the finished load was taken out. Clears the Clean state and any unload reminder.Fields: Device
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
A Home Assistant integration that watches an appliance through its smart plug. It detects each cycle, recognises which program ran from the power curve, and tells you how long is left.
Works with washing machines, dryers, washer-dryers, dishwashers, air fryers, bread makers and pumps. Two catch-all types cover the rest: Other (Advanced) (full program matching) and Threshold Device (on/off detection only).
Shows in Vulpo
Button card, Select card, Chart card, Apple Watch.Information
- Installs
- 9.2k sharing analytics
- GitHub stars
- 1.4k
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v0.5.8,
- Category
- Appliances and cleaning, Laundry
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
ha_washdata- Issues
- Report an issue
