Get it on your TV
couch-tv is the free app on your TV that shows your design. You put it on once. Pick the kind of TV you have to see its steps.
- Google TVSony, TCL, Hisense, Toshiba, Philips, Google TV Streamer
- Android TVSays Android TV OS in Settings, Nvidia Shield
- Fire TVFire TV Stick and Cube
- SamsungFrom 2018 on, The Frame too
- LGFrom 2018 on
- RokuRoku TVs and sticks, with couch-tv's own looks
- Hisense VIDAAHisense TVs that run VIDAA
- Other or not sureFind your model
Not sure what it runs? On the TV, open Settings, System, About. If it says Android TV OS and the home has For you, Live, Shows and Apps along the top, pick Google TV. Otherwise pick Android TV.
Already have couch-tv? Update couch-tv on your TV. Your design and settings stay.
Would you rather not do this part yourself? That is fine. It takes about 10 minutes, and some steps go into the TV's settings. Nothing on the TV is deleted, and it can be undone. Ask someone handy, like a family member or a friend, to do it with you.
Stuck part way? Email info@underseage.studio with your TV's model and the step you got to.
Google TV Works
Your design becomes your home screen. Sony, TCL, Hisense, Toshiba, Philips and others, and the Google TV Streamer.
- Time
- About 15 minutes
- You need
- Your TV remote. A computer once gives your design the Home button too
- On your TV
- Your design, as your home screen
- Home button
- Opens Google TV's home, unless you use a computer once
- Phone remote
- Works, if you add it on the Couch TV screen
Easiest: just the TV remote, no computer
Google keeps its own Home button, so Home still opens Google TV. You open your design from Couch TV in your apps row.
On the TV, go to Apps at the top, then Search for apps, and type Downloader.
Google TV has no Play Store tile: the app search is in the Apps tab.
Choose Downloader by AFTVnews, the first one. Press Install, then Open.
Several of the results are orange. The right one says Downloader by AFTVnews under it. It is free.
Downloader opens on a news page with adverts and a small red circle. Press Up again and again until the red circle is gone and the Downloader button at the top left turns light. Then press Right twice, to the # button, and press OK.
It can take 15 presses or more: the red circle is a pointer, and it climbs the page first. Press one at a time, not held down. Right once lands on the white box: typing the code there works too.
It says Enter a numeric short code. Type 8180170 with the number pad on the screen, then press the tick (or Load).
8180170
8180170 is couch-tv's own Downloader code, and it always gets the newest couch-tv. Some versions say Go instead of Load.
The TV says it is not allowed to install unknown apps. Press right until SETTINGS is lit up, then press OK.
It may say phone instead of TV, and nothing may look lit up at first: the first press can land on CANCEL. If you pressed CANCEL by mistake, type the code in Downloader again.
Go down to Downloader, press OK to switch it on, then press Back.
The list starts on another app, like CaptivePortalLogin. Leave that one as it is. The warning above the list is Android's usual one for any app from outside the Play Store. This only lets Downloader put couch-tv on, and you can switch it off again after.
If Downloader closed, open it again, press Up until the Downloader button turns light, Right twice to #, type 8180170 again and press the tick.
Many TVs close Downloader after you allow it. Your place is not saved, so the code goes in once more.
The TV asks: Do you want to install this application? Press right to Install, then press OK. Then press Open.
Cancel is lit up first, so move right before you press OK. On your TV the app is called Couch TV. Its picture may be a dark square with a letter H.
If Google Play Protect says App blocked to protect your device, press OK. Then switch off Scan apps with Play Protect, install couch-tv again, and switch it back on.
Play Protect is in Settings, Apps, Security and restrictions, Google Play Protect on most TVs (on some: the Google Play Store app, your picture, Play Protect, the gear). It checks apps from outside the Play Store, and couch-tv is one of those. Not shown? Skip this step.
Couch TV opens. Press Open the home. That is your couch-tv home.
Skip Use as home screen on Google TV: installed this way, the Home button still opens Google TV, even if you switch it on. Only the watch app put on from a computer (the With a computer way) makes Home open your design.
Optional: point your phone's camera at the QR code on the Couch TV screen, open the page, and type the 6 digit phone code.
Your phone becomes a remote. Phone and TV must be on the same Wi-Fi. The code lasts 3 minutes: press New phone code for another.
From now on, press Home, go to Couch TV in your apps row and press OK, then Open the home. (If Home already opens couch-tv, just press Home.)
So it is easy to find, hold OK on Couch TV in the apps row and choose Move, then move it to the front.
Now make your design and send it to the TV.
With a computer once: the Home button opens your design
Which Android does your TV have? On the TV open Settings, System, About, and look at Android TV OS version. It is a number like 11 or 12.
Android TV OS 12 or newer
On a Mac or Windows computer, download the free Setup app.
It is on couch-tv's GitHub release page, under Assets. Pick the zip for your computer. Not sure which Mac? Apple menu, About This Mac: "Chip: Apple M" means M1 or newer.
All the files, with their checksums, are on couch-tv's GitHub release page.
Unzip it and open it. Say you trust it, once.
Mac: System Settings, Privacy and Security, Open Anyway. Windows: More info, then Run anyway. Mac: when it asks to find devices on your local network, press Allow. Missed it, or it says Something went wrong? System Settings, Privacy and Security, Local Network: switch on couch-tv Setup, then open it again.
On the TV open Settings, System, About. Check Android TV OS version says 12 or more. Then go down to Android TV OS build and press OK 7 times.
The TV says you are now a developer. It says 11 or less? Go back and choose the Android 11 way.
Press Back, open Developer options and switch on Wireless debugging.
Careful: Revoke USB debugging authorisations sits just above it. Check what is lit up before you press OK.
In the Setup app press Start, then pick your TV.
The TV must be on, on the same Wi-Fi as the computer.
On the TV, choose Pair device with pairing code. Type the 6 digit code the TV shows into the Setup app.
It is inside Wireless debugging. Leave that screen open while you type.
Check the plan, then press Yes, set it up.
Nothing changes on the TV before this.
Press Home on the TV. Your couch-tv home opens.
Now make your design and send it to the TV.
Android TV OS 11 (many 2021 and 2022 TCL, Hisense and Toshiba)
These TVs have no Wireless debugging, so the computer comes in through USB debugging, over your Wi-Fi. Some of them never show the question that lets a computer in. If yours does not, use the TV remote way above: everything works except the Home button.
On a Mac or Windows computer, download the free Setup app.
It is on couch-tv's GitHub release page, under Assets. Pick the zip for your computer. Not sure which Mac? Apple menu, About This Mac: "Chip: Apple M" means M1 or newer.
All the files, with their checksums, are on couch-tv's GitHub release page.
Unzip it and open it. Say you trust it, once.
Mac: System Settings, Privacy and Security, Open Anyway. Windows: More info, then Run anyway. Mac: when it asks to find devices on your local network, press Allow. Missed it, or it says Something went wrong? System Settings, Privacy and Security, Local Network: switch on couch-tv Setup, then open it again.
On the TV open Settings, System, About. Go down to Android TV OS build and press OK 7 times.
The TV says you are now a developer. Android TV OS version on the same screen should say 11.
Press Back, open Developer options and switch on USB debugging.
No cable is needed: on these TVs it also lets a computer in over Wi-Fi. If you see Network debugging or ADB over network too, switch that on as well.
Press Home so the TV shows its home screen. In the Setup app press Start and pick your TV.
If it asks what kind of TV it is, choose Android TV: that is the one for TVs with only USB debugging.
Look at the TV: Allow USB debugging? Tick Always allow from this computer, move to OK and press it.
It can take up to a minute to appear.
No question on the TV? Open Developer options, switch USB debugging off and on again, press Home, then start again in the Setup app.
Still nothing? In Developer options press Revoke USB debugging authorisations, switch USB debugging off and on, and try once more. That only signs out computers that used debugging on this TV before. If the TV still never asks, it does not let a computer in this way: use the TV remote way.
Check the plan, then press Yes, set it up.
Nothing changes on the TV before this.
Press Home on the TV. Your couch-tv home opens.
Now make your design and send it to the TV.
Good to know
- Google's own home stays on underneath. Nothing is deleted, and Undo in the Setup app puts it back.
- The Setup app is on couch-tv's GitHub release page, under Assets.
- Turning the TV on from your phone needs a computer left on at home. Everything else does not.
Stuck? The Google TV help page, or email info@underseage.studio with your TV's model and the step you got to.
Android TV Works
Your design becomes your home screen, Home button and all. All you need is the TV remote.
- Time
- About 15 minutes
- You need
- Your TV remote. Your phone is handy too. No computer
- On your TV
- Your new home screen
- Home button
- Opens your design
- Phone remote
- Works, if you add it on the Couch TV screen
A home with For you, Live, Shows, Movies and Apps along the top is Google TV: use the Google TV steps.
On the TV, open Google Play Store, choose the search at the top and type Downloader.
No Play Store in your apps? Look under Apps, or use the TV's search with the microphone button.
Choose Downloader by AFTVnews, the first one. Press Install, then Open.
Several of the results are orange. The right one says Downloader by AFTVnews under it. It is free.
Downloader opens on a news page with adverts and a small red circle. Press Up again and again until the red circle is gone and the Downloader button at the top left turns light. Then press Right twice, to the # button, and press OK.
It can take 15 presses or more: the red circle is a pointer, and it climbs the page first. Press one at a time, not held down. Right once lands on the white box: typing the code there works too.
It says Enter a numeric short code. Type 8180170 with the number pad on the screen, then press the tick (or Load).
8180170
8180170 is couch-tv's own Downloader code, and it always gets the newest couch-tv. Some versions say Go instead of Load.
The TV says it is not allowed to install unknown apps. Press right until SETTINGS is lit up, then press OK.
It may say phone instead of TV, and nothing may look lit up at first: the first press can land on CANCEL. If you pressed CANCEL by mistake, type the code in Downloader again.
Go down to Downloader, press OK to switch it on, then press Back.
The list starts on another app, like CaptivePortalLogin. Leave that one as it is. The warning above the list is Android's usual one for any app from outside the Play Store. This only lets Downloader put couch-tv on, and you can switch it off again after.
If Downloader closed, open it again, press Up until the Downloader button turns light, Right twice to #, type 8180170 again and press the tick.
Many TVs close Downloader after you allow it. Your place is not saved, so the code goes in once more.
The TV asks: Do you want to install this application? Press right to Install, then press OK. Then press Open.
Cancel is lit up first, so move right before you press OK. On your TV the app is called Couch TV. Its picture may be a dark square with a letter H.
If Google Play Protect says App blocked to protect your device, press OK. Then switch off Scan apps with Play Protect, install couch-tv again, and switch it back on.
Play Protect is in Settings, Apps, Security and restrictions, Google Play Protect on most TVs (on some: the Google Play Store app, your picture, Play Protect, the gear). It checks apps from outside the Play Store, and couch-tv is one of those. Not shown? Skip this step.
Couch TV opens. Press Use as home screen.
The TV asks which home to use. Choose Couch TV, then Always.
Some TVs ask Set Couch TV as your default home app? instead: choose Couch TV, then SET AS DEFAULT. Missed it? Press Home and the TV asks again.
Optional: point your phone's camera at the QR code on the Couch TV screen, open the page, and type the 6 digit phone code.
Your phone becomes a remote. Phone and TV must be on the same Wi-Fi. The code lasts 3 minutes: press New phone code for another.
Press Home on the TV remote. couch-tv's home opens.
Now make your design and send it to the TV.
Good to know
- Works from Android TV 7.1. Android 6 needs couch-tv 0.13 or later and is set up from a computer.
- Turning the TV on from your phone needs a computer left on at home.
Stuck? The Android TV help page, or email info@underseage.studio with your TV's model and the step you got to.
Fire TV Works
Your design goes on top of Amazon's home and takes the Home button back.
- Time
- About 10 minutes
- You need
- A Mac or Windows computer, once
- On your TV
- Your Home screen, over Amazon's
- TV remote
- Works, Home button too
- Phone remote
- Opens apps. Keys and typing need a computer left on
On a Mac or Windows computer, download the free Setup app.
It is on couch-tv's GitHub release page, under Assets. Pick the zip for your computer. Not sure which Mac? Apple menu, About This Mac: "Chip: Apple M" means M1 or newer.
All the files, with their checksums, are on couch-tv's GitHub release page.
Unzip it and open it. Say you trust it, once.
Mac: System Settings, Privacy and Security, Open Anyway. Windows: More info, then Run anyway. Mac: when it asks to find devices on your local network, press Allow. Missed it, or it says Something went wrong? System Settings, Privacy and Security, Local Network: switch on couch-tv Setup, then open it again.
On the Fire TV open Settings, My Fire TV, About. Press OK on the TV's name 7 times.
The TV says you are now a developer.
Press Back, open Developer options and switch on ADB debugging.
In the Setup app press Start and pick your Fire TV.
On the TV, tick Always allow, then press Allow.
Check the plan, then press Yes, set it up.
Press Home. Amazon's home flashes up, then your couch-tv home comes back.
Now make your design and send it to the TV.
Good to know
- Works on Fire OS 6, 7 and 8. Fire OS 5 is too old.
- A Fire TV Stick 4K Select or another stick on Vega OS can't take this app. It has its own version, built on a computer: Vega OS guide.
Stuck? Read the full guide
Samsung Works
Your design is an app that opens by itself every time the TV comes on.
- You need
- A Mac or Windows computer for a 30 minute setup, and a free Samsung account
- On your TV
- An app. Opening by itself needs a computer left on
- TV remote
- Works in the app. Home opens Samsung's menu
- Phone remote
- Works, with the computer on
On a Mac or Windows computer, download couch-tv-samsung-setup.zip and unzip it.
It is on couch-tv's GitHub release page, under Assets. Mac: double-click the zip. Windows: right-click it, then Extract All.
Find your computer's address.
The computer's address is like 192.168.1.20. Mac: System Settings, Wi-Fi, Details, IP address. Windows: Settings, Network and internet, Wi-Fi, your network, IPv4 address. Or open the setup first: it shows the address.
On the TV, open Apps and press 1 2 3 4 5 on the remote.
No number buttons (The Frame, most 2021 and newer): press 123 (on some, four coloured dots) and pick the numbers on screen, or use the 123 pad in the free SmartThings phone app. 2022 and newer: if nothing happens, open App Settings at the bottom of Apps, then press 1 2 3 4 5.
Switch Developer mode on, type your computer's address, then press OK.
Type each number as it is: 1, not 001. Right moves to the next group.
Restart the TV: hold the power button about 5 seconds, until it goes off and on again.
On The Frame a short press only turns on Art Mode.
On the computer, double-click Install on Mac.command (Windows: Install on Windows.cmd).
Mac, if it is blocked: System Settings, Privacy & Security, Open Anyway, and Allow if it asks to find devices on your network. Windows: More info, Run anyway, then allow Private networks.
Sign in to Samsung in the browser that opens.
It is Samsung's own page: the setup never sees your password. Agree or Allow if Samsung asks.
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.
Opening by itself at every switch-on and the phone remote need a computer left on at home. That part is optional.
Now make your design and send it to the TV.
Good to know
- Samsung's Home button still opens Samsung's menu. Press Back, or open the app from the app row.
- The computer has to stay on for your design to open by itself. Without it, open the app from the app row.
- Samsungs from before 2018 (Tizen 4.0) are too old.
Stuck, or a Frame remote with no numbers? Read the Samsung help
LG Works
Your design is an app that opens by itself every time the TV comes on.
- You need
- A computer left on at home, best a Mac or Linux
- On your TV
- An app that opens itself
- TV remote
- Works in the app. Home opens LG's menu
- Phone remote
- Works, with the computer on
On a computer or phone, make a free LG developer account.
On the TV, open the LG Content Store (or Apps) and install Developer Mode.
Open Developer Mode, sign in, and switch Dev Mode Status on.
The TV restarts.
Open Developer Mode again and switch Key Server on. Leave it open.
Note the 6 character passphrase it shows. The AI agent asks you for it.
On the computer, open Claude Code or another AI agent and paste this.
Set this up on my TV: github.com/Seagey/couch-tvIt puts the free couch-tv app on the TV and asks you before it changes anything.
Say yes to the plan. On the TV, move to Accept first, then press OK.
Do it within two minutes. Pressing OK the moment it appears can say no by mistake.
Now make your design and send it to the TV.
Good to know
- LG removes the app when Developer Mode runs out. The computer at home tops it up once a day. With none, the app asks you once a week.
- LG's Home button still opens LG's menu. webOS 3 and older are too old.
Stuck? Read the full guide
Roku Works
couch-tv runs as a channel that opens by itself every time the TV comes on, with its own looks. To show a couch-tv Studio design on this TV, plug in a Google TV box.
- You need
- A computer left on at home, best a Mac or Linux
- On your TV
- A channel that opens itself
- TV remote
- Works in the channel. Home opens Roku's home
- Phone remote
- Works, with the computer on
On the Roku home press Home 3 times, Up 2 times, then Right, Left, Right, Left, Right.
Choose Enable installer and restart. Make up a password and keep it.
No Roku account needed. Note the address the screen shows.
Settings, System, Advanced system settings, Control by mobile apps: set Network access to Permissive or Enabled.
On the computer, open Claude Code or another AI agent and paste this.
Set this up on my TV: github.com/Seagey/couch-tvIt builds the free couch-tv channel and asks for your password when it puts it on.
Your design is kept in couch-tv Studio. To show it on this TV, plug in a Google TV box.
Good to know
- A Roku holds one channel like this. Putting another one on replaces couch-tv.
- The channel has run on one real Roku TV so far.
- Volume and power from the phone work on a Roku TV, not a Roku stick.
Stuck? Read the full guide
Hisense VIDAA Works
Your design opens in the TV's browser every time the TV comes on.
- You need
- A computer left on at home, and on newer TVs an Android phone, once
- On your TV
- A page in the TV's browser
- TV remote
- Arrows and OK on VIDAA 9. Older TVs point and click
- Phone remote
- Works, with the computer on
On the TV open Settings, Network, Network Status. Write down the IP address.
It looks like 192.168.1.20. Some TVs call it Network Info.
On the computer, open Claude Code or another AI agent and paste this.
Set this up on my TV: github.com/Seagey/couch-tvNewer TVs: it walks you through taking a certificate from Hisense's VIDAA app on an Android phone, once.
Type the 4 digit code the TV shows into the AI agent.
Switch the TV off and on. couch-tv opens in a few seconds.
Now make your design and send it to the TV.
Good to know
- Confirmed on a Hisense 55U7N with VIDAA 9.
- VIDAA's Home button still opens VIDAA's home.
- Hisense TVs that run Google TV use the Google TV steps.
Stuck? Read the full guide
Other or not sure
It depends on what the TV runs, not the brand.
On the TV, open Settings, System, About.
Older TVs: Settings, Device Preferences, About.
See Android TV OS there? A home with For you, Live, Shows and Apps along the top is Google TV. Otherwise it is Android TV.
Still not sure? Type your model in the box at the top.
Other TVs
- Apple TV Works An app put on from a Mac, opened by a computer left on, with couch-tv's own looks. For a Studio design, plug in a Google TV box. Guide
- Panasonic Works A page in the TV's browser, opened by a computer left on. Guide
- TiVo OS (JVC, Telefunken) Works A page in the TV's browser, opened by a computer left on. Guide
- Older Philips (Saphi) Works Depends on the set, with a computer left on at home. A two minute test tells you. Guide
- Philips Titan OS and VIZIO: the phone remote works. For a Studio design, plug in a Google TV box.
Want the whole thing on any TV?
Plug in a Google TV box, like the Google TV Streamer, and follow the Google TV steps on that. It works on any TV with an HDMI port.
Google TV stepsHaven't made your design yet? Designing is free and needs no account.
Start designingChanged your mind? Take couch-tv off your TV: the TV remote is enough.