🧭 Decision Guide
Why trending now: Cannot be determined from the provided materials
Try it if you
-
You use Home Assistant and can provide a local-network IP address for the Samsung appliance.README section “Add an appliance”: enter the appliance's IP address, and LocalThings reads its model and adds a Home Assistant device.
-
You want LocalThings to stop contacting Samsung servers after initial setup.README sections “Updates are fast” and “It works without the internet”: after setup, LocalThings never contacts Samsung's servers; adding the first appliance is an exception and contacts them once.
-
Your Samsung appliance was made around 2022 or later.README section “What it supports”: most Samsung appliances from about 2022 onward work.
-
You need pushed status updates and Home Assistant controls for a washer, dryer, or air conditioner.README section “Built on open standards”: CoAP Observe is used for push updates; the support table lists washers, dryers, and air conditioners.
Skip it if you
-
You require that Samsung servers never be contacted, including during first-time appliance setup.README section “Add an appliance” explicitly says that adding the first appliance contacts Samsung's servers once.
-
Your appliance refuses the automatic certificate and you cannot obtain a pre-shared key.README section “Add an appliance”: some appliances need a pre-shared key, and LocalThings cannot obtain it for you.
-
You want to remove the appliance from SmartThings while continuing to use it reliably.README section “Known device behavior”: removing it from SmartThings resets network settings when it next reaches Samsung's servers and causes it to drop off Wi-Fi.
-
You depend on continuously accurate washer or dryer energy totals while the appliance cannot reach SmartThings.README section “Known device behavior”: DA_WM_TP2_20_COMMON appliances stop increasing the energy total when they cannot reach SmartThings.
Requirements
- Run Home Assistant and add LocalThings from “Settings > Devices & Services > Add Integration”.
- Install LocalThings through HACS, or copy custom_components/localthings/ into the Home Assistant configuration directory.
- Restart Home Assistant.
- Provide an IP address for the Samsung appliance.
- The first appliance requires access to Samsung servers to read a public identifier; later appliances need only an IP address.
- Keep the appliance registered in SmartThings.
- An appliance that refuses the automatic certificate needs a usable pre-shared key; older TCP 8888 appliances need a device token.
Watch out
-
During brief disconnects, entities retain their last values; frequent reconnects should prompt a check of the appliance's Wi-Fi signal.README section “Known device behavior”: brief disconnects are normal; check the appliance's Wi-Fi signal if reconnects happen several times a minute.
-
A Samsung appliance accepts only one connection, so another client can conflict with LocalThings.README section “Known device behavior”: an appliance accepts one connection at a time.
-
Enabling “Allow writes even when remote control is reported off” can cause commands to be silently ignored by the appliance.README section “Per-device settings”: the default rejects commands because the appliance would ignore them without saying so.
-
Some multi-device appliances create duplicate or empty Subdevices that must be unchecked in Device settings.README section “Per-device settings”: some appliances report an extra slot that is not real hardware.
-
A new appliance must be reachable during setup; an appliance previously reached successfully can show unavailable after a Home Assistant restart while powered off.README section “Restarting while an appliance is powered off”.
Alternatives
-
SmartThings app:It is better when you need Samsung's official cloud management, or when the appliance cannot connect through LocalThings' OCF and CoAP over DTLS local interface; the README identifies SmartThings app as the existing connection method for these appliances.README sections “What it supports” and “Known device behavior”
Not stated in the README
- The README does not state the minimum supported Home Assistant version.
- The README does not provide a complete compatibility list by Samsung model; it only gives “about 2022 onward” and appliance-type coverage.
- The README does not specify the network ports that must be allowed for CoAP, DTLS, or TCP 8888.
- The README does not explain how to use the Dockerfile; installation only describes HACS and custom_components/localthings/.
- The README does not state the number of entities exposed by each appliance type or the model-specific feature differences.
- The README does not identify the complete model range affected by automatic-certificate failure; it only says that some appliances need a pre-shared key.
💡 Deep Analysis
6
No
I plan to feed the energy totals from a Samsung WW80T654ALX washer and DV80T6220LX dryer into Home Assistant. I want totals to keep increasing while the appliances are offline. Is LocalThings suitable as an energy data source?
No, not as a reliable cumulative meter during offline periods, because the README explicitly documents that these models stop increasing their energy total when they cannot reach SmartThings.
- The README names the DA_WM_TP2_20_COMMON board, including WW80T654ALX and DV80T6220LX: the energy total stops increasing while the appliance cannot reach SmartThings and resumes after connectivity returns.
- LocalThings can only display the resource recorded by the appliance; it cannot reconstruct missing consumption. A value that remains unchanged in Home Assistant does not necessarily mean the appliance used no power.
- The project can expose an energy-use sensor, but having that entity is not the same as guaranteeing continuous accumulation while offline.
- If your constraint is continuous, outage-proof energy measurement, the README gives no guarantee and LocalThings should not be your sole source.
- Known device behavior: "Some washers and dryers stop counting energy without SmartThings."
- Known device behavior: "WW80T654ALX and DV80T6220LX"
- Known device behavior: "LocalThings can only show what the appliance records"
- What it supports: typical sensors include energy use
Yes
I maintain a Python Home Assistant custom integration and have more than 90 captures from real Samsung appliances. I want to add entities for a new model without modifying the CoAP or DTLS protocol code. Is LocalThings a suitable contribution base?
Yes. The project separates protocol communication from Home Assistant entity mapping, so a new model can usually be extended through a declarative capability table without changing the protocol layer.
- The README says smartthings-local owns the protocol layer, while LocalThings handles configuration, entities, and lifecycle management. That matches your goal of changing only capability mapping.
- Each appliance type uses a table to map resources reported by the appliance to Home Assistant entities, and tests validate those tables against more than 90 captures from real appliances.
- The README explicitly says a new model usually needs a table entry and no protocol code, so your captures can be used to verify resources and entity mappings directly.
- The project is released under the MIT License, making modification and redistribution practical. However, an unsupported capability still needs diagnostic confirmation rather than inference from the model name alone.
- Built on open standards: "The smartthings-local library implements the protocol layer."
- Built on open standards: "Declarative appliance maps"
- Built on open standards: "Tests check the tables against 90+ captures from real appliances"
- Built on open standards: "a new model usually needs a table entry and no protocol code"
- Project data: main_language is Python; license is MIT License
Yes
I already run Home Assistant with Samsung washers and refrigerators from around 2022 onward. I want control traffic to stay on my home network and remain usable during an internet outage. Is LocalThings suitable?
Yes, it is a good fit because this is the local Home Assistant use case LocalThings targets, but “works offline” does not mean the appliance itself can permanently operate without Samsung connectivity.
- The README says LocalThings communicates with washers, refrigerators, and other appliances over the home network and, after setup, “LocalThings never contacts Samsung’s servers.”
- Most Samsung appliances from about 2022 onward are supported. For most devices, setup only requires an IP address; the integration discovers the type and model and creates matching entities.
- Push-capable appliances update immediately, while others are checked every 30 seconds, so local operation continues during an outage but non-push devices may have delayed state.
- The appliance may still need Samsung connectivity to maintain SmartThings registration. Removing it from SmartThings can reset network settings, so permanently blocking appliance internet access is not an unconditional assumption.
- README: "It works without the internet. After setup, LocalThings never contacts Samsung's servers."
- README: "Most Samsung appliances from about 2022 onward work"
- README: "Appliances that support push send changes as they happen. LocalThings checks the rest every 30 seconds."
- Known device behavior: "Keep appliances registered in SmartThings."
It depends
I use Home Assistant through HACS, but my target Samsung appliance rejects the automatic X.509 certificate. I can obtain a pre-shared key externally, but I do not want to depend on a Samsung account login. Is LocalThings suitable?
It depends. LocalThings supports importing a pre-shared key and does not require a Samsung account login, but appliances that reject the automatic certificate are not plug-and-play.
- The README supports installation through HACS and configuration through the Home Assistant UI. Most appliances need only an IP address, but appliances rejecting the automatic certificate enter an additional authentication flow.
- The project uses CoAP over DTLS with an X.509 client certificate for encrypted communication. For some appliances, setup asks you to import a pre-shared key when the automatic certificate is refused.
- The README explicitly says LocalThings cannot obtain that key for you, so you must solve credential acquisition and secure storage yourself.
- It also mentions the public AC14K_M CA certificate, but no appliance that refused the automatic certificate has been reported to accept it. It should therefore not be treated as a dependable fallback.
- Install: "In HACS, go to Integrations, search for LocalThings"
- Built on open standards: "CoAP over DTLS ... with an X.509 client certificate"
- Add an appliance: "Some appliances refuse the automatic certificate"
- Add an appliance: "LocalThings can't obtain" the pre-shared key
Yes
I have a multi-unit air conditioner or double-cavity oven and want to control each sub-device separately in Home Assistant. Can I still use LocalThings if discovery creates empty sub-devices?
Yes, but you must accept that discovery can create empty sub-devices and handle them in Home Assistant device settings.
- The README explicitly lists “Air conditioner, including multi-unit systems” and Oven among supported appliance types, so both target categories are in scope.
- The project insights note that multi-unit air conditioners and double-cavity ovens may be identified with extra empty sub-devices. This does not necessarily indicate a protocol failure; it reflects a mismatch between reported capability mapping and physical structure.
- LocalThings creates entities from resources reported by the appliance. Typical entities include modes, temperatures, remaining time, and alarms, but the actual sub-device contents depend on those resources.
- If every sub-device must map exactly to physical hardware, the README gives no guarantee of perfect discovery. However, the project supports hiding incorrectly recognized empty sub-devices, so it remains usable.
- What it supports: "Air conditioner, including multi-unit systems"
- What it supports: "Oven"
- Project insight: multi-unit air conditioners and double-cavity ovens may be identified with extra empty sub-devices
- Project insight: users can hide incorrectly recognized empty sub-devices
It depends
I have an older Samsung washer or air conditioner rather than a post-2022 model, and it uses the legacy TCP 8888 interface. I can provide a device token. Is LocalThings worth adopting?
It depends. The project explicitly supports some older appliances using TCP 8888, but that does not guarantee complete compatibility for your exact model.
- The README says that some earlier washers, air conditioners, and wall ovens use an older local interface. During setup, LocalThings detects which interface the appliance has and reports when none is found.
- TCP 8888 appliances require an additional device token, so an IP address alone is not enough. Credential acquisition and maintenance are more involved than for newer devices.
- The README also states that older-model support is incomplete and depends on the firmware, model, and resources actually exposed by the appliance. Even a successful setup may not create every control entity.
- Adoption is therefore realistic if your model is recognized and you can obtain the token. If you require every mode, program, and write operation, the README makes no such guarantee.
- What it supports: "so do some earlier washers, air conditioners and wall ovens that use an older local interface"
- What it supports: "Setup detects which interface an appliance has, and tells you if it finds none."
- Add an appliance: "Older appliances on TCP 8888 ask for a device token."
- Project insight: compatibility depends on firmware, model, and local interface implementation; older-model support is incomplete.
✨ Highlights
-
Control Samsung appliances locally from Home Assistant
-
Supports OCF, CoAP Observe, and DTLS
-
Appliance maps are tested against 90+ real captures
-
Most Samsung appliances from about 2022 onward work
🔧 Engineering
-
Discovers the model from an IP address and creates Home Assistant entities
-
Uses CoAP Observe for push updates and polls others every 30 seconds
-
Supports Samsung washers, refrigerators, air conditioners, ovens, and more
-
Declarative appliance maps usually require only a table entry
⚠️ Risks
-
Adding the first appliance contacts Samsung's servers once
-
Some appliances refuse the automatic certificate and need a pre-shared key
-
Older appliances on TCP 8888 require a device token
-
An appliance accepts one connection, so other connections can cause disconnects
-
Some washers and dryers stop recording energy without SmartThings
👥 For who?
-
Home network users managing Samsung appliances with Home Assistant
-
Users who want cloud-free control and can provide an appliance IP address
-
Developers willing to handle OCF, DTLS certificates, or TCP 8888 devices