Control Samsung appliances on your local network without internet access
Imagine controlling your washing machine or refrigerator even when the internet is down. LocalThings connects Home Assistant directly to Samsung appliances, allowing commands to be exchanged without passing through cloud servers. Once you know the appliance's IP address, the tool automatically identifies its type and model, creating the necessary buttons and sensors.
How it works without the cloud
LocalThings communicates using OCF and CoAP, the standard protocols used by the appliances. Data travels through DTLS encrypted sessions, and the system supports push updates that notify you immediately when an appliance changes its state. For other appliances, it checks the status every 30 seconds. Once setup is complete, it does not connect to Samsung servers, so control remains possible even if the internet is cut. However, the appliances themselves maintain a connection to Samsung servers, so deleting an appliance from the SmartThings app may reset its network settings.
Supported appliances and control scope
Most Samsung appliances released after 2022 and some older models are supported. This includes washing machines, dryers, refrigerators, air conditioners, ovens, robot vacuums, and air purifiers. Individual outdoor units of multi-split air conditioners and separate compartments of dual ovens are recognized as distinct devices. Depending on the information reported by the appliance, you can control or check power, mode selection, start/stop, temperature, remaining time, door status, and energy usage. Some models are supported in read-only mode only, and certain appliances, such as ovens or microwaves, may have modes where remote start is not possible.
Installation and initial setup
You can install LocalThings by searching for it in HACS or by copying the custom_components/localthings/ folder into the Home Assistant configuration folder. After restarting Home Assistant, select LocalThings from Settings > Devices & Services > Add Integration. Enter the appliance's IP address, and LocalThings will automatically connect and read the device information. When adding the first appliance, it connects to the Samsung server once to retrieve the public identifier, but subsequent additions can be made without internet using only the IP address. Some older appliances use TCP port 8888, in which case you need to enter a device token.
Things to check before use
The appliance must be registered in SmartThings to maintain its network settings. If you delete the appliance from SmartThings, its Wi-Fi settings will be reset, requiring reinstallation. Some washing machines and dryers may stop recording energy usage if they are not connected to SmartThings. Additionally, appliances allow only one connection at a time, so if another device is connected, LocalThings may disconnect it. If the IP address changes, appliances that report their MAC address are detected automatically, but others must be reconfigured manually.
