This is a Samsung TV integration tutorial based on Home Assistant 2025.12.2+ and written specifically for beginners.
Core principle (plain version)
Home Assistant (HA) controls a Samsung TV mainly through a combination of two methods:
- Local network control: HA sends commands directly to the TV over your home WiFi/ethernet cable (volume adjustment, channel switching). This requires the TV to be powered on and to allow being controlled.
- SmartThings cloud control (highly recommended): New Samsung TVs cut off their local network connection when powered off to save energy, so HA cannot directly wake the TV up (turn it on). By linking a Samsung SmartThings account, HA can send a power-on command through the cloud, solving the pain point of being able to turn the TV off but not on.
Step 1: TV-side settings (critical! you cannot connect without this step)
Before connecting the TV to HA, you must first open the TV’s remote control door. Menus differ slightly between models, but they are broadly the same:
- Fixed IP address (recommended):
- It is recommended to set the TV’s IP as a fixed IP in your router admin panel (for example 192.168.1.100), so that HA can still find the TV after a restart changes its IP.
Enable IP control permission:
- Take the TV remote and go to: Settings -> General -> Network -> Expert Settings.
- Find IP Remote or Power On with Mobile and turn them all on (Enable/On).
Adjust notification settings (to avoid harassment):
- Go to: Settings -> General -> External Device Manager -> Device Connection Manager.
- Change Access Notification to First Time Only. If you do not change this, the TV screen will pop up a dialog asking you to allow every command HA sends from now on.
Step 2: Get a SmartThings token (solves the cannot power on problem)
If you only want simple power-off and volume control and do not care about being able to turn the TV on with HA, you can skip this step. But for a perfect experience, it is recommended.
- Open in your computer browser: .
- Log in with your Samsung account (it must be the same account you are logged into on the TV).
- Click “Generate new token”.
- Token Name: anything you like, for example HomeAssistant.
- Authorized Scopes: select all (check every box; even though only some permissions are needed, selecting all is easiest for beginners and avoids missing any).
- Click “Generate token” at the bottom.
- Important: the page will show a long string of characters (starting with something like xxxxxxxx-xxxx…). Copy and save it immediately! This string is only shown once, and you cannot get it back after closing the page.
Step 3: Add the TV in Home Assistant
Make sure the TV is powered on and on the same local network as HA.
- Open the Home Assistant web interface.
- Click Settings in the left menu -> Devices & Services.
- Usually HA will automatically discover your TV and show it under Discovered at the top.
- Case A: automatic discovery
- Click Configure.
- HA will ask whether to connect; click Submit.
Case B: no automatic discovery
- Click + Add Integration in the bottom right corner.
- Search for Samsung and select Samsung Smart TV.
- Host: enter the TV’s IP address (for example 192.168.1.100).
- Name: give it any name, for example Living Room TV.
Watch the TV screen
:
- At this point a window may pop up in the top right corner of the TV: “Allow Home Assistant to connect?”.
- Quickly pick up the remote and select Allow. If you miss it, you may have to start over.
Enter the SmartThings token (if prompted):
- HA may pop up a dialog asking you to enter the SmartThings API Key (or Token).
- Paste in the string you copied in step 2.
- Note: if no dialog asks you for the Token, do not worry; after adding successfully you can check the integration’s Options, or it may have been recognized automatically.
Step 4: Verify and troubleshoot
After a successful add, go to the HA Overview page and you should see a media player card.
- Test power on/off:
- Click the power-off icon and the TV should turn off.
- Wait 1 minute, then click the power-on icon. If SmartThings is configured, the TV should light up.
If the state does not update (it always shows off, but the TV is actually on):
- This is network latency; it usually syncs within a few seconds to tens of seconds.
If it cannot be turned on:
- Check whether your TV is connected to the 5G WiFi band. Some older Samsung TVs disconnect deeply from the network after sleeping under 5G WiFi and cannot be reached. Try connecting to 2.4G WiFi or plugging in an ethernet cable.
- Confirm that the SmartThings Token from step 2 is configured correctly.
Extra commonly used features
In HA Automation you can do things like this:
- Trigger: when media_player.living_room_tv changes from off to on.
- Action: automatically dim the living room lights and close the curtains.
Now you have successfully integrated your Samsung TV into Home Assistant 2025.12.2+!
