localthings

localthings

Lets Home Assistant control Samsung washers, dryers, refrigerators, air conditioners and ovens over your local network, without a cloud account. For Home Assistant owners with SmartThings compatible appliances.

Made by mbillow on GitHub. These notes are Mindket's, written from its README; the project's own files and license are in its repository.

About

What it is: LocalThings is a Home Assistant integration for Samsung appliances that work with the SmartThings app. It reaches each appliance on your local network, so no cloud account is needed. After setup it never contacts Samsung's servers.

Who it suits: LocalThings suits Home Assistant owners with Samsung appliances who want control that stays inside the home.

Industry | Who uses it | How they use it | Example
Smart homes | Home Assistant owners | Control Samsung appliances from Home Assistant | Checking and controlling a dryer from Home Assistant
Privacy conscious households | Homeowners | Keep appliance control on the home network | Controlling a dryer without sending a command to Samsung's servers
Homes with unreliable internet | Anyone offline at times | Keep control working without internet | Checking an oven's state while the internet is down
Home automation | Automation builders | Use the created controls and sensors in automations | Reacting when a dryer reports a change

People without Home Assistant, or without Samsung appliances that work with SmartThings, can skip it.

Where to use it: LocalThings runs inside Home Assistant and talks to appliances on your home network.

• Home Assistant, as a custom component that its topics also tie to HACS
• Your home network, where each appliance is reached by its IP address

Use case | Who | What they get back
Washers and dryers | Households | Matching controls and sensors in Home Assistant
Refrigerators and air conditioners | Households | Controls and sensors made for each model
Ovens and other appliances | Households | Updates at once when push is supported, else a check every 30 seconds

How to set it up: You need three things first:

• Home Assistant
• A Samsung appliance that works with the SmartThings app
• The appliance's IP address on your home network

1. Add LocalThings to Home Assistant by following the project's README.
2. Enter the IP address of one appliance.
3. For most appliances, LocalThings works out the type and model by itself.
4. Use the matching controls and sensors it creates.

How to use it: Day to day you use the controls and sensors that LocalThings creates in Home Assistant. Appliances with push support report changes the moment they occur, and LocalThings polls the others every 30 seconds.

Example: You add a dryer by its IP address. LocalThings works out its model and creates matching controls and sensors, which then show up in Home Assistant.

For newcomers and experts: Home Assistant is software that runs a smart home, and LocalThings lets it talk to your Samsung appliances directly inside your house instead of through Samsung's cloud. Setup asks for an IP address, so find that for one appliance first.

Its topics point to CoAP and DTLS for the local link, and the code is Python. That design trades the cloud for your own network, so setup needs an IP address, and updates come by push or by polling depending on the appliance.

You enter an appliance's IP address
LocalThings works out its type and model
It creates matching controls and sensors
Push appliances update at once
Other appliances are polled on a timer

Good to know: This kit holds notes and a pointer to the code, so nothing runs by itself.

• License: MIT
• Cost to run: none named, and no cloud account is needed
• Data it reaches: appliances on your local network. LocalThings sends nothing to Samsung, though each appliance keeps its own Samsung connection.
• Not for: appliances that do not work with the SmartThings app

On GitHub, 8 November 2026

• Stars: 1,070 (186 that day)
• Forks: 112
• Watching: 5
• Open issues and pull requests: 95
• Language: Python
• License: MIT
• Topics: coap-protocol, coap-server, custom-component, dtls, hacs, hacs-integration, home-assistant, home-automation, samsung, smartthings
• Trending: #12 repository of the day on GitHub trending (8 November 2026)

Links

• Code: https://github.com/mbillow/localthings
• Releases: https://github.com/mbillow/localthings/releases
• Issues: https://github.com/mbillow/localthings/issues
• Star history: https://www.star-history.com/#mbillow/localthings&Date

Get the code

git clone https://github.com/mbillow/localthings.git

Then follow the setup in its README. Nothing in this kit runs by itself.