Samsung
Updated .
From 2018 on, couch-tv goes on as an app, with a Mac or Windows computer for about 30 minutes and a free Samsung account. The computer is only needed for the setup.
Step by step
On a Mac or Windows computer, download couch-tv-samsung-setup.zip and unzip it.
Find your computer's address.
On the TV, open Apps and press 1 2 3 4 5 on the remote.
Switch Developer mode on, type your computer's address, then press OK.
Restart the TV: hold the power button about 5 seconds, until it goes off and on again.
On the computer, double-click Install on Mac.command (Windows: Install on Windows.cmd).
Sign in to Samsung in the browser that opens.
Press Allow on the TV if it asks. couch-tv goes on the TV and opens.
Make couch-tv come back by itself: on the TV, Settings, General, Smart Features, Autorun Last App, On.
No number buttons on the remote
- The Frame and most Samsungs from 2021 on have no number buttons. Press 123 (on some, four coloured dots) and pick the numbers on screen.
- Or use the free SmartThings app on your phone: its remote has a 123 pad.
- 2022 and newer: if nothing happens in Apps, open App Settings at the bottom of Apps, then press 1 2 3 4 5.
It says the TV is not ready
- Switch the TV on with its remote first. A TV that is off or asleep cannot be found. On The Frame, a short press: it falls asleep by itself after a while in Art Mode.
- To keep it reachable: on the TV, Settings, General, Network, Expert Settings, Power On with Mobile: On.
- Developer mode is off: on the TV, Apps, then 1 2 3 4 5, and switch it on again. It can switch itself off after a Samsung software update.
- The address typed in Developer mode is not this computer's. The setup shows the right one: "This computer's address is".
- The TV was not restarted by holding the power button about 5 seconds after Developer mode was switched on.
- Fix it on the TV, then press Return in the setup window (Windows: Enter) to check again.
How it updates
- couch-tv on a Samsung does not update itself. When a new one is out, the TV says so on the couch-tv home.
- Then download the newest couch-tv-samsung-setup.zip and run it again (Install on Mac.command or Install on Windows.cmd). Your settings stay.
Remove it
- On the TV: Apps, the cog (Settings), Couch TV, Delete.
- To switch Developer mode off: Apps, 1 2 3 4 5, Developer mode Off, then restart the TV.
Using a different tool
- The setup uses Apps2Samsung, a free community tool (not Samsung's, GPL-3.0). Its desktop app works too: pick your TV, choose your own .wgt, pick couch-tv-samsung.wgt from couch-tv's GitHub release page, then Install.
- For AI agents and developers, the full guide is docs/SAMSUNG.md on github.com/Seagey/couch-tv.
Good to know
- Samsung's Home button still opens Samsung's menu. To open couch-tv, press Home, move to Couch TV in the row of apps, then press OK.
- Opening by itself at every switch-on and the phone remote need a computer left on at home. That part is optional.
- Samsungs from before 2018 (Tizen 4.0) are too old.
Still stuck? Ask the helper, or copy a ready question for your own AI.