# couch-tv Studio help: every article as plain text > Plain steps for couch-tv Studio (https://couchtv.joshuaseage.com/), a free designer for TV home screens, and couch-tv, the free app on the TV. Updated 20 November 2026. Each article is also at its own address under https://couchtv.joshuaseage.com/help/. More facts: https://couchtv.joshuaseage.com/llms.txt. The design file format, for tools that write designs: https://couchtv.joshuaseage.com/help/design-format/ (JSON Schema: https://couchtv.joshuaseage.com/help/design-format.schema.json) ## Get couch-tv on your TV ### Put couch-tv on your TV: start here Source: https://couchtv.joshuaseage.com/help/install-start/ couch-tv is the free app that shows your design on the TV. You put it on once. Here is the easy way for each TV. 1. Find out what your TV runs. On the TV open Settings, then System, then About. It says Google TV, Android TV, Fire TV, or the brand's own system. 2. Google TV or Android TV: you only need the TV remote, no computer. Open Get it on your TV on your phone and press Google TV or Android TV. 3. Google TV with the Home button too, or Fire TV: you need a Mac or Windows computer once, for about 10 minutes. The free Setup app, from couch-tv's GitHub release page, does the hard part. 4. Samsung, LG or Hisense VIDAA: these need a computer left on at home and a few developer settings. This is the one to ask someone for help with. 5. Once couch-tv is on the TV, make your design in couch-tv Studio and press Send to my TV. Your TV asks before anything changes. - Nothing on your TV is deleted. You can always go back to the old home screen. - Not sure which TV you have? Type the model from the sticker on the back into the box on Get it on your TV. - Roku and Apple TV run couch-tv with its own looks. For a couch-tv Studio design on them, plug in a Google TV box. Q: Do I need a computer to put couch-tv on my TV? A: Not on Google TV or Android TV: the TV remote is enough. Fire TV needs a computer once. Samsung, LG and Hisense VIDAA need a computer left on at home. Q: Can I undo it? A: Yes. couch-tv never deletes the TV's own home screen, and you can go back to it from Home settings on the TV. ### Get someone to help you install couch-tv Source: https://couchtv.joshuaseage.com/help/install-help/ Putting couch-tv on a TV is the hardest step. It is fine to ask a family member or friend. Send them this page. 1. Ask someone who is happy using a computer. They need about 10 to 20 minutes with your TV, the TV remote and your Wi-Fi. 2. Press Email the steps to a helper below. It opens your email with the steps filled in. Add their address and send it. 3. Tell them what your TV is (the brand and, if you can, the model from the sticker on the back). 4. They follow Get it on your TV for your kind of TV. Google TV and Android TV need only a phone; Fire TV needs a computer once; Samsung, LG and Hisense VIDAA need a computer left on at home. 5. When couch-tv is on, you can do the rest yourself: make a design and press Send to my TV. The TV asks before it changes anything. - Your helper does not need your passwords. Nothing is bought and nothing on the TV is deleted. - Still stuck after that? Email info@underseage.studio with your TV's brand and model, and we will tell you which steps to follow. Q: Who can help me install couch-tv? A: Anyone who is happy using a computer, like a family member or friend. Send them the steps with Email the steps to a helper. Q: What does my helper need? A: About 10 to 20 minutes with your TV, the remote and your Wi-Fi. Some TVs need a Mac or Windows computer too. ### Which TV do I have? Source: https://couchtv.joshuaseage.com/help/which-tv/ It depends on what the TV runs, not the brand. The TV's About screen tells you. 1. On the TV, open Settings, then System, then About. Older TVs: Settings, Device Preferences, About. 2. See Android TV OS or Google TV there? Use the Google TV or Android TV steps. 3. Samsung from 2018 on runs Tizen, LG runs webOS, many Hisense run VIDAA. 4. Still not sure? Type the model from the sticker on the back of the TV into the box on Get it on your TV. - Plug in a Google TV box, like the Google TV Streamer, and any TV with an HDMI port gets the whole thing. ### Google TV Source: https://couchtv.joshuaseage.com/help/tv-google/ Your design becomes your home screen, with just the TV remote. Google keeps its own Home button, so you open your design from Couch TV in the apps row. 1. On the TV, go to Apps at the top, then Search for apps, and type Downloader. 2. Choose Downloader by AFTVnews, the first one. Press Install, then Open. 3. 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. 4. It says Enter a numeric short code. Type 8180170 with the number pad on the screen, then press the tick (or Load). 5. The TV says it is not allowed to install unknown apps. Press right until SETTINGS is lit up, then press OK. 6. Go down to Downloader, press OK to switch it on, then press Back. 7. If Downloader closed, open it again, press Up until the Downloader button turns light, Right twice to #, type 8180170 again and press the tick. 8. The TV asks: Do you want to install this application? Press right to Install, then press OK. Then press Open. 9. 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. 10. Couch TV opens. Press Open the home. That is your couch-tv home. 11. 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. 12. 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.) - Want the Home button to open your design? Do it with a Mac or Windows computer once: see Google TV with a computer. - Google's own home stays on underneath. Nothing is deleted. - Turning the TV on from your phone needs a computer left on at home. Nothing else does. Q: Does it delete Google's home? A: No. Google's home stays on underneath. Q: Why does Home still open Google TV? A: Google keeps the Home button on Google TV. Open your design from Couch TV in the apps row, or use a computer once so Home opens it. ### Google TV with a computer (Android 12 or newer) Source: https://couchtv.joshuaseage.com/help/tv-google-computer/ With a Mac or Windows computer once, the Home button opens your design too. For Google TVs on Android TV OS 12 or newer. 1. On a Mac or Windows computer, download the free Setup app. 2. Unzip it and open it. Say you trust it, once. 3. 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. 4. Press Back, open Developer options and switch on Wireless debugging. 5. In the Setup app press Start, then pick your TV. 6. On the TV, choose Pair device with pairing code. Type the 6 digit code the TV shows into the Setup app. 7. Check the plan, then press Yes, set it up. 8. Press Home on the TV. Your couch-tv home opens. - Which Android? On the TV open Settings, System, About, and look at Android TV OS version. - Google's own home stays on underneath. Nothing is deleted, and Undo in the Setup app puts it back. ### Google TV on Android 11, with a computer Source: https://couchtv.joshuaseage.com/help/tv-google-11/ Android 11 Google TVs have no Wireless debugging. The computer comes in through USB debugging, over Wi-Fi. Some never ask to let it in: then use the TV remote way. 1. On a Mac or Windows computer, download the free Setup app. 2. Unzip it and open it. Say you trust it, once. 3. On the TV open Settings, System, About. Go down to Android TV OS build and press OK 7 times. 4. Press Back, open Developer options and switch on USB debugging. 5. Press Home so the TV shows its home screen. In the Setup app press Start and pick your TV. 6. Look at the TV: Allow USB debugging? Tick Always allow from this computer, move to OK and press it. 7. No question on the TV? Open Developer options, switch USB debugging off and on again, press Home, then start again in the Setup app. 8. Check the plan, then press Yes, set it up. 9. Press Home on the TV. Your couch-tv home opens. - If the TV never shows Allow USB debugging?, it does not let a computer in this way. The TV remote way still works: everything except the Home button. ### Android TV Source: https://couchtv.joshuaseage.com/help/tv-android/ Your design becomes your home screen, Home button and all, set up with just the TV remote. 1. On the TV, open Google Play Store, choose the search at the top and type Downloader. 2. Choose Downloader by AFTVnews, the first one. Press Install, then Open. 3. 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. 4. It says Enter a numeric short code. Type 8180170 with the number pad on the screen, then press the tick (or Load). 5. The TV says it is not allowed to install unknown apps. Press right until SETTINGS is lit up, then press OK. 6. Go down to Downloader, press OK to switch it on, then press Back. 7. If Downloader closed, open it again, press Up until the Downloader button turns light, Right twice to #, type 8180170 again and press the tick. 8. The TV asks: Do you want to install this application? Press right to Install, then press OK. Then press Open. 9. 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. 10. Couch TV opens. Press Use as home screen. 11. The TV asks which home to use. Choose Couch TV, then Always. 12. 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. 13. Press Home on the TV remote. couch-tv's home opens. - Works from Android TV 7.1. Android 6 needs couch-tv 0.13 or later and is set up from a computer. - A home with For you, Live, Shows and Apps along the top is Google TV: use the Google TV steps. ### Fire TV Source: https://couchtv.joshuaseage.com/help/tv-fire/ Your design goes on top of Amazon's home and takes the Home button back. A Mac or Windows computer once. 1. On a Mac or Windows computer, download the free Setup app. 2. Unzip it and open it. Say you trust it, once. 3. On the Fire TV open Settings, My Fire TV, About. Press OK on the TV's name 7 times. 4. Press Back, open Developer options and switch on ADB debugging. 5. In the Setup app press Start and pick your Fire TV. 6. On the TV, tick Always allow, then press Allow. 7. Check the plan, then press Yes, set it up. 8. Press Home. Amazon's home flashes up, then your couch-tv home comes back. - Works on Fire OS 6, 7 and 8. Fire OS 5 is too old. - When you press Home, Amazon's home flashes up first, then your design comes back. - Sticks on Vega OS (like the Fire TV Stick 4K Select) have their own version, built on a computer. ### Samsung Source: https://couchtv.joshuaseage.com/help/tv-samsung/ 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. 1. On a Mac or Windows computer, download couch-tv-samsung-setup.zip and unzip it. 2. Find your computer's address. 3. On the TV, open Apps and press 1 2 3 4 5 on the remote. 4. Switch Developer mode on, type your computer's address, then press OK. 5. Restart the TV: hold the power button about 5 seconds, until it goes off and on again. 6. On the computer, double-click Install on Mac.command (Windows: Install on Windows.cmd). 7. Sign in to Samsung in the browser that opens. 8. Press Allow on the TV if it asks. couch-tv goes on the TV and opens. 9. Make couch-tv come back by itself: on the TV, Settings, General, Smart Features, Autorun Last App, On. - 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. 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. ### LG Source: https://couchtv.joshuaseage.com/help/tv-lg/ From 2018 on (webOS 4.10), your design is an app that opens by itself. It needs a computer left on at home. 1. On a computer or phone, make a free LG developer account. 2. On the TV, open the LG Content Store (or Apps) and install Developer Mode. 3. Open Developer Mode, sign in, and switch Dev Mode Status on. 4. Open Developer Mode again and switch Key Server on. Leave it open. 5. On the computer, open Claude Code or another AI agent and paste this: Set this up on my TV: github.com/Seagey/couch-tv 6. Say yes to the plan. On the TV, move to Accept first, then press OK. - LG removes the app when Developer Mode runs out. The computer at home tops it up once a day. - LG's Home button still opens LG's menu. ### Hisense VIDAA Source: https://couchtv.joshuaseage.com/help/tv-vidaa/ Your design opens in the TV's browser each time the TV comes on, with a computer left on at home. 1. On the TV open Settings, Network, Network Status. Write down the IP address. 2. On the computer, open Claude Code or another AI agent and paste this: Set this up on my TV: github.com/Seagey/couch-tv 3. Type the 4 digit code the TV shows into the AI agent. 4. Switch the TV off and on. couch-tv opens in a few seconds. - Confirmed on a Hisense 55U7N with VIDAA 9. - Hisense TVs that run Google TV use the Google TV steps. ### Roku, Apple TV and other TVs Source: https://couchtv.joshuaseage.com/help/tv-other/ On Roku and Apple TV couch-tv draws its own home: scenes, clock, weather, Keep watching and your apps. A couch-tv Studio design needs a TV that can run a web page. 1. Roku and Apple TV: couch-tv's own home, with the scenes, clock, weather, Keep watching and your apps. A Roku channel and an Apple TV app cannot run the web page a design is drawn by, so a design does not change it. 2. Panasonic (My Home Screen), TiVo OS and older Philips (Saphi): a page in the TV's browser, opened by a computer left on. Your design shows there. 3. VIZIO: a computer at home opens couch-tv's home in the TV's own web view (tried on one set), and your design shows there. Philips Titan OS: the phone remote works; Titan opens only apps from its own store, so the home stays Philips's. 4. Want it today on any TV with HDMI? Plug in a Google TV box and follow the Google TV steps on that. ### Take couch-tv off your TV Source: https://couchtv.joshuaseage.com/help/remove-couch-tv/ With just the TV remote: switch Google TV Home back on if it is off, then uninstall the couch-tv apps. Nothing on the TV is deleted. 1. On the couch-tv home, open the Settings gear (at the end of the app row, or top right on a design), then pick TV settings. 2. Open Apps, then See all apps, then Show system apps. 3. If Google TV Home or Setup says Disabled, open it and press Enable. Do this first: without it the TV has no home screen after the next step. 4. Back in Apps, open the couch-tv Home app and press Uninstall. Do the same for Couch TV (the app that lives on the TV), and Couch TV watch if you have it. 5. Press Home. The TV's own home is back. - With the computer you set it up with (about 1 minute): in the couch-tv folder run TV_IP= DEV_OFF=1 sh tv-home/tools/remove-all.sh. It puts the TV's own home back, removes the couch-tv apps and switches Developer options off. If it cannot reach the TV it changes nothing and shows the TV-remote steps. - Then, if you like: in Settings, System, Developer options press Revoke USB debugging authorisations, switch Network debugging and USB debugging off, then Developer options itself. - On a Samsung or LG, delete Couch TV from the TV's app list (Samsung: Apps, the cog, Couch TV, Delete). - Only want your old home back for a while? Back to my classic home in Home settings keeps couch-tv: see Go back to your old home. ### Update couch-tv on your TV Source: https://couchtv.joshuaseage.com/help/update-couch-tv/ How you update depends on how couch-tv went on. Your design and settings stay either way. 1. See which couch-tv you have: on the TV, press the gear (or the Settings tile), then Home settings, then About. It shows the version. 2. Updates in Home settings? Choose it, then Check for updates now, then Update to the new version, and confirm on the screen that opens. 3. Put on with your phone and Downloader (no Updates there)? Open Downloader, press Up until the Downloader button at the top left turns light, press Right twice to #, type 8180170 and press the tick. That code always gets the newest couch-tv. Press Install when the TV asks. 4. If Downloader says App not installed, the TV is usually short of space. In Downloader open Files, delete the old couch-tv-ontv files, then type 8180170 again. 5. From couch-tv 0.13.6 the phone way also has Update couch-tv in Home settings, About: it shows the steps above with the newest version. 6. Samsung: download the newest couch-tv-samsung-setup.zip and run it again, as when you put it on (Samsung help). From couch-tv 0.13.7, Home settings, About on a Samsung shows the version and an Update couch-tv row. Any other TV: update couch-tv the same way it was put on. - Updating never removes your design, your guest's name or your settings. - A new version is listed on couch-tv's GitHub release page. With Tell me about new versions on, the TV looks once a week and puts a dot on the Settings tile. Q: How do I update couch-tv on my TV? A: Home settings, Updates, Check for updates now. If there is no Updates (couch-tv put on with Downloader), type Downloader's code 8180170 again: it always gets the newest couch-tv. On a Samsung, run the newest setup zip again. Q: Do I lose my design when I update? A: No. Your design and settings stay. ## Make a design ### Make a design Source: https://couchtv.joshuaseage.com/help/make-design/ Pick your TV, pick a look, then change anything. Free, in your phone or computer browser, no account. 1. Open couch-tv Studio and pick your TV (or press Not sure, let me design first). 2. Pick a look to start from, like Couch Night or Family Photo Wall. 3. Tap anything on the TV to change it. Add brings in more widgets. 4. Undo and Redo are at the top. Your design stays in this browser as you go. 5. When it looks right, press Send to my TV to put it on your TV. - The apps you see are examples. On your own TV, your own apps show in their place. - The speed bar at the top (Smooth) shows how much your design asks of your TV. - Already made a layout somewhere else? Upload the file (https://couchtv.joshuaseage.com/help/upload-file/) and we will check it. - Making the file with an AI tool? Point it at the design file format (https://couchtv.joshuaseage.com/help/design-format/) and its JSON Schema (https://couchtv.joshuaseage.com/help/design-format.schema.json). Q: Do I need an account to design? A: No. Designing, downloading and sending to your TV are free with no account. Q: Where is my design kept? A: In your own browser until you send, save or share it. ### Bring your couch-tv home into Studio Source: https://couchtv.joshuaseage.com/help/bring-home/ Already use couch-tv from GitHub? On the TV, Home settings, couch-tv Studio, Open this home in couch-tv Studio. Type the code it shows, and your home opens here, ready to change. 1. On the TV, open Home settings (the gear at the end of your apps), then couch-tv Studio. You do not need to turn couch-tv Studio on for this. 2. Choose Open this home in couch-tv Studio. On couch-tv 0.13.0 to 0.13.2 it is called Share this home. The TV shows a QR code and a code like K7M2Q-XR4TP. 3. Point your phone's camera at the QR code. Or open couch-tv Studio on your phone or computer and type the code under Already use couch-tv from GitHub? 4. Your home opens in the designer: the same apps in the same order, the same scenes, clock, glass and dock. Change anything you like. 5. Press My designs to keep it in your account, then Send to my TV to put it back on the TV with a new code. - Only the look and your apps leave the TV. People's names, your photos, your place, Home Assistant tokens, AI keys and calendar links never do. If the TV finds anything private in the home, it sends nothing. - The code works once, for 30 minutes. Ask the TV again for a new one. - Your TV shows the Classic or OLED look? Designs are drawn over the Night look, so your settings come across on Night. - No Open this home or Share this home on your TV? It is older than 0.13. Update it (Home settings, Updates), or bring it in from your computer (https://couchtv.joshuaseage.com/help/bring-home-file/). Q: Does my TV change when I do this? A: No. The TV only shows a code. Nothing on it changes until you send a design back and say yes on the TV. Q: Can I go back to my old home? A: Yes. On the TV, Home settings, couch-tv Studio, Back to my classic home. ### Bring your couch-tv home in from your computer Source: https://couchtv.joshuaseage.com/help/bring-home-file/ For a TV older than couch-tv 0.13: open couch-tv Studio on the computer that set it up, press Open my config.json and pick config.json in your couch-tv folder. 1. On the computer that set up couch-tv, find your couch-tv folder (the one you downloaded from GitHub). Your settings are in config.json in that folder. 2. Open couch-tv Studio on that computer and press Open my config.json under Already use couch-tv from GitHub? (or Open a file at the bottom). 3. Pick config.json. Never pick .env: it only holds keys and tokens, and Studio never needs it. 4. Your home opens: the scenes, clock, glass and dock. A card lists what stayed on your computer on purpose, like your people, weather place and TVs. 5. Want your apps in your order too? Put config.json and bridge/data/app-order..json in one zip and open the zip instead. 6. Change anything, press My designs to keep it, then Send to my TV. - Nothing in config.json is kept by Studio. Your people, weather place, TV addresses, the computer at home, Home Assistant, Plex and bookings sections are left out before anything is shown. - Settings you changed on the TV itself (Home settings) are not in config.json. For those, bring it in from the TV (https://couchtv.joshuaseage.com/help/bring-home/) once the TV runs couch-tv 0.13 or newer. ### Move, resize or remove things Source: https://couchtv.joshuaseage.com/help/move-resize/ Drag a widget to move it. Tap it for Size, Swap, Stack, Pin, Duplicate and Delete. 1. Drag a widget on the TV to move it. The others make room. 2. Tap it once. A panel opens with Size, Swap, Stack, Pin, Duplicate and Delete. 3. Size picks a set size, like iPhone widgets. Swap changes it for another widget in the same place. 4. Pin keeps a widget still while you drag others. Stack makes a smart stack that takes turns. 5. Made a mistake? Press Undo at the top. - Layout: Widget grid snaps widgets to rows and columns. Free lets words and shapes sit anywhere inside the safe area. - On a computer: arrow keys nudge, Delete removes, press ? for every shortcut. ### Change which apps show Source: https://couchtv.joshuaseage.com/help/change-apps/ Tap the dock or an app folder, then tick the apps you want and drag them into order. You can change them on the TV too. 1. Tap the dock, an app folder or an app grid on the TV. 2. Search for an app (like Stan or ZEE5) and tick it to add it. 3. Drag apps to change their order, or press the cross to take one out. 4. With none picked, the TV shows every app it has. 5. On the TV itself: hold OK on an app for Change app, Move, Remove and Add app. - An app that is not on your TV shows as Not on this TV until you install it. - Hold OK on the TV needs couch-tv 0.13 or newer. ### Fonts, colours and background Source: https://couchtv.joshuaseage.com/help/look-fonts/ Swap the look, pick a scene or your own photo for the background, and change fonts and colours per widget. 1. With nothing picked, the panel shows Background: scenes, photos, a plain colour, darken, zoom and blur. 2. Swap the look at the top changes the whole design to another look. 3. Drop in your own photo to make it the background. It stays in your browser until you send it. 4. Tap a widget with words to change its font, weight, colour and shadow. 5. More fonts gives about 1,800 from Google Fonts. Your TV gets them through our site, so Google never sees your TV. - Your own photo only goes to the TV if you tick Send my own photo too when you send. ### Save, download or open a design Source: https://couchtv.joshuaseage.com/help/save-download/ It stays in this browser by itself. Save a copy (file) keeps a file. My designs keeps it in your account. 1. Your design stays in this browser as you go. Come back and press Carry on with your last design. 2. Save a copy (file) saves a file (a .json, or a .zip when it has your own photo). 3. My designs keeps it in your account, so it is on your phone and your computer. A free account keeps 1; Creator keeps more. 4. To open a design file, press Open a file. For a design your AI made, press Design with your AI and paste it into the paste box. - Private browsing may not keep your design after you close the tab. Press Save a copy (file) to be safe. - Already made a layout somewhere else? Upload the file (https://couchtv.joshuaseage.com/help/upload-file/) and we will check it. - Making the file with an AI tool? Point it at the design file format (https://couchtv.joshuaseage.com/help/design-format/) and its JSON Schema (https://couchtv.joshuaseage.com/help/design-format.schema.json). ### Check it before it goes on the TV Source: https://couchtv.joshuaseage.com/help/check-design/ Watch the speed bar, then try it with a remote in the designer. 1. The speed bar at the top says how hard your design works your TV: keep it on Smooth. 2. Tap it for tips, like making frosted panels solid. 3. On a computer, press Try it with the remote: arrow keys and Enter drive the real home. 4. Turn on Safe area to see where TVs may cut off the edges. - The speed bar is an estimate from each TV's published chip and memory, not measured on your TV. ## Widgets ### Add a widget Source: https://couchtv.joshuaseage.com/help/add-widget/ Press Add, find the widget, tap it. Then tap it on the TV to size it and see what it needs. 1. Press Add at the bottom. 2. Search, or tap a group: Time, Weather, Photos, Watching, Apps, Music, Smart home, Lists, Info, Guests and kids. 3. Tap the i on a widget to see what it shows on a real TV. 4. Tap the widget to add it. It lands on your TV. 5. Tap it on the TV: the panel says Works straight away, or the steps to set it up for your TV. ### Set up a widget on your TV Source: https://couchtv.joshuaseage.com/help/widget-setup/ Some widgets need one thing on the TV, like your town or your photos. Until then they show a setup card, never made up data. 1. Tap the widget in the designer. Its panel says what it needs on your kind of TV. 2. Your town (weather, sun, surf, air): on the TV, open Home settings, then Location. 3. Your photos: add them on the TV, or put one photo straight in the widget in the designer. 4. Things you pick in the designer (world clocks, countdown, bin night, welcome words) go with the design. 5. On the TV, press OK on a setup card to see the steps there too. - Keep watching, Up next and Now playing need the couch-tv TV app, or a computer at home that stays on. - Aircon and Scenes need Home Assistant running at home. ### Clocks and time widgets Source: https://couchtv.joshuaseage.com/help/widgets-time/ Every clock works straight away from the TV's own clock. A few need one thing picked. 1. Press Add, then Time. 2. Tap a clock to add it, then tap it on the TV and press Size. 3. World clocks and Countdown: pick the cities or the date in the widget's panel. - Digital clock: The time, with the date if you like. Works straight away. - Tall clock: Tall thin digits that fill the space. Works straight away. - Glass clock: Big digits filled with the scene's photo. Works straight away. - Analogue clock: A clock face with hands. Works straight away. - Flip clock: Digits on flip cards. Works straight away. - Time in words: "Twenty to eight, Wednesday morning". Works straight away. - Date: Today's date, with the weather if you like. Works straight away. - Month: This month's calendar, with today marked. Works straight away. - World clocks: The time in two to four cities. Set it in the designer (The cities, picked in couch-tv Studio). - Countdown: Sleeps, days or weeks to a date. Set it in the designer (The date and its name, picked in couch-tv Studio). - Timer: A ring counting down a timer you start with the remote. Works straight away. - Sun clock: The sun's path today, with sunrise and sunset. Set up on the TV (Your town, set on the TV). ### Weather widgets Source: https://couchtv.joshuaseage.com/help/widgets-weather/ They need your town, set once on the TV. Weather comes free from Open-Meteo, no account. 1. Press Add, then Weather, and add one. 2. On the TV, open Home settings, then Location, and pick your town. 3. Home settings, Weather sets °C or °F and how often it updates. - Weather: Your town, the temperature, the sky, the high and low. Set up on the TV (Your town, set on the TV). - Big number: One huge temperature, coloured for the day. Set up on the TV (Your town, set on the TV). - Hourly: The next few hours: time, sky and temperature. Set up on the TV (Your town, set on the TV). - This week: The next 7 days, with each day's high and low. Set up on the TV (Your town, set on the TV). - Rain soon: Rain in the next three hours, as bars. Set up on the TV (Your town, set on the TV). - UV index: Today's UV and how strong it is. Set up on the TV (Your town, set on the TV). - Sunrise and sunset: Today's sunrise and sunset, and the sun's path. Set up on the TV (Your town, set on the TV). - Moon: Tonight's moon and the next full moon. Works straight away. - Air quality: How clean the air is, as a number and a word. Set up on the TV (Your town, set on the TV). - Surf: The swell (height, seconds apart, direction) and the wind at the coast nearest your town. Set up on the TV (Your town, set on the TV: pick the beach town nearest you; A town near the coast: inland there is no swell). - Surf needs a town near the coast: inland there is no swell. - Show the temperature once: hide the small weather line if you have a weather card. ### Photo widgets Source: https://couchtv.joshuaseage.com/help/widgets-photos/ Show your photos from the TV, or put one photo straight into the widget. 1. Press Add, then Photos, and add one. 2. Put a photo in it in the designer, or add your photos on the TV. 3. When you send, tick Send my own photo too, or the TV shows a scene instead. - Photo: One of your photos. Set up on the TV (Your photos on the TV, or one photo put in the widget). - Slideshow: Your photos, one after another. Set up on the TV (Your photos on the TV, or one photo put in the widget). - Photo mosaic: Three to five of your photos in a collage. Set up on the TV (Your photos on the TV, or one photo put in the widget). - Art frame: One photo in a frame with a label. Set up on the TV (Your photos on the TV, or one photo put in the widget). - On this day: Your photos taken on this date in other years, with how long ago. Set up on the TV (Your photos on the TV, with the day each was taken; Photos taken on this day in another year). - Photos are redrawn before they are stored, which removes hidden details like where a photo was taken. ### Watching and music widgets Source: https://couchtv.joshuaseage.com/help/widgets-watching/ Keep watching, Up next and Now playing need the couch-tv TV app or a computer at home. Soundscape works straight away. 1. Press Add, then Watching or Music. 2. Add the widget and size it. 3. Tap it to see what it needs on your TV. Until then the TV shows a setup card. - Keep watching: The show you were watching, ready to carry on. Needs a little setup (The couch-tv TV app or a computer at home that stays on). - Keep watching row: Two to five shows, with how far you got. Needs a little setup (The couch-tv TV app or a computer at home that stays on). - Up next: One show filling the space, with Resume and Start over. Beside Scores it shows your last game. Needs a little setup (The couch-tv TV app or a computer at home that stays on). - Now playing: The song playing on this TV: cover, song and artist. Needs a little setup (The couch-tv TV app or a computer at home that stays on). - Soundscape: Rain, fire, waves or soft noise, played by the home. Works straight away. - Picks for you: Shows the others at home are watching, and your own shows left part way, each ready to play. Needs a little setup (The couch-tv TV app or a computer at home that stays on). - Up next queue: The next songs in your Spotify queue. Needs a little setup (Spotify connected on the home computer, or on the website home on a Hisense; Only Spotify: TVs and other music apps do not share their queue). - Speakers: Each speaker, what it plays and its volume. Set up on the TV (Home Assistant (a smart home app) running at home; Your speakers picked on the TV). ### App widgets Source: https://couchtv.joshuaseage.com/help/widgets-apps/ The dock, app folders, app grids, one big app and games. They show the apps on your TV. 1. Press Add, then Apps. 2. Add a dock, folder or grid, then tap it to pick and order the apps. 3. Icon shape, style and labels are in the widget's panel. - Dock: A row of your apps. Works straight away. - App folder: A box of apps with a name. Set it in the designer (The apps, picked in couch-tv Studio and installed on this TV). - App grid: Rows of apps with their names. Works straight away. - One app: One app as a big icon. Set up on the TV (The app installed on this TV). - Games: Game apps as tall tiles. Set it in the designer (Game apps installed on this TV). ### Smart home widgets Source: https://couchtv.joshuaseage.com/help/widgets-smart/ Aircon, Scenes, Control Centre, Camera, Doorbell, Solar and energy, and Sensor work with Home Assistant at home, on Google TV, Android TV and Fire TV. Batteries reads the TV's own paired remotes. 1. You need Home Assistant (a free smart home app) running at home. 2. Press Add, then Smart home, and add Aircon or Scenes. 3. Add your aircon rooms or scenes once on a computer, as the widget's panel shows. - Aircon: A room's set temperature, what it is now, and the other rooms. Set up on the TV (Home Assistant (a smart home app) running at home; Your aircon rooms picked on the TV). - Scenes: Your Home Assistant scenes as big buttons (Movie night, Goodnight). Set up on the TV (Home Assistant (a smart home app) running at home; Your scenes picked on the TV). - Custom card: Your own title and words, or a live number from your home: solar today, the pool. Set it in the designer (Your title and words, typed in couch-tv Studio; For a live number: a computer at home that stays on, running couch-tv). - Control Centre: Lights, switches, fans and blinds as big switches. Set up on the TV (Home Assistant (a smart home app) running at home; Your lights and switches picked on the TV). - Camera: A still picture from a camera, new every 2 seconds (no video). Set up on the TV (Home Assistant (a smart home app) running at home; Your cameras picked on the TV). - Doorbell: When the doorbell last rang, with a picture. Set up on the TV (Home Assistant (a smart home app) running at home; Your doorbell picked on the TV). - Solar and energy: Power made or used today, by the hour. Set up on the TV (Home Assistant (a smart home app) running at home; Your solar or energy sensor picked on the TV). - Sensor: One reading (the pool, the rain gauge, humidity) and its last 24 hours. Set up on the TV (Home Assistant (a smart home app) running at home; Your sensors picked on the TV). - Batteries: The remotes, game controllers and headphones paired with this TV, and the charge left in each, as rings. Set up on the TV (A Google TV, Android TV or Fire TV, with Bluetooth remotes or controllers that report their charge). - In the designer, smart home cards show made up numbers. The TV shows yours. ### Lists, info, guests and kids widgets Source: https://couchtv.joshuaseage.com/help/widgets-everyday/ Bin night, people, quotes, word of the day, welcome words, quick buttons and smart stacks work straight away. The rest work once they are set up, with the steps on the TV. 1. Press Add, then Lists, Info or Guests and kids. 2. Bin night and Welcome words: set them in the widget's panel. They go with the design. 3. People: add the people who watch on the TV itself. 4. A smart stack holds up to 10 widgets of one size that take turns in one place. - Bin night: Tonight's bins with their lid colours. Set it in the designer (Your bin night and bins, picked in couch-tv Studio). - People: Who is watching. OK switches person. Set up on the TV (The people who watch, added on the TV). - Welcome words: A greeting in your own words, or each guest by name with their check in or check out time from your bookings calendar. Set it in the designer (The words, typed in couch-tv Studio; For guest names: your Airbnb, Booking.com or VRBO calendar link, typed on the TV). - Quote: A short line for the day, or your own words. Works straight away. - Word of the day: A word and what it means. Works straight away. - Quick buttons: Sleep timer, picture mode, look, input and more. Set up on the TV. - Smart stack: Up to 10 widgets of one size taking turns in one place. Set it in the designer (Whatever the widgets in it need). - Agenda: Today's events with times and colours, from your own calendar. Set up on the TV (Your calendar's private address, typed on the TV; Something to read the calendar: the couch-tv TV home, or a computer at home). - Family note: A sticky note typed at home, with who it is from. Set up on the TV (A note typed on the TV). - List: Shopping or to do, ticked with OK on the remote. Set up on the TV (A list typed on the TV). - Headlines: One to four of the latest headlines from a news feed you pick (ABC News unless you choose another). Set it in the designer. - Scores: This round's games with their scores, live ones first: AFL, NRL, A-League, Premier League, NBA, Big Bash or cricket. Set it in the designer. - Markets: Your watchlist: the ASX 200, the dollar and Bitcoin unless you pick others, each with today's move. ASX prices are about 20 minutes late. Set it in the designer. - Commute: The usual drive to work or school by road, and when to leave to arrive on time. No live traffic. Set up on the TV (Your town, and where you drive to, set on the TV (never in the design)). - Guest Wi-Fi: Your guest network, its password and a code a phone camera joins with. Set up on the TV (The guest Wi-Fi's name and password, typed on the TV). - House guide: Check out, the bins, around here: what guests need to know. Set up on the TV (The guide, typed on the TV). - Screen time: Time in apps on this TV today, against a daily goal. Set up on the TV (A Google TV, Android TV or Fire TV that allows screen time). - Ask AI: Ask anything by voice or typing, answered on the TV by the AI you pick. Set up on the TV (The AI you choose: Claude, OpenAI, Google Gemini or another service, a model at home, or couch-tv at home; Your own key for that service, kept on this TV (a model on a computer at home needs none)). - From your AI: Messages your own AI agent sends to the TV. The agent can also put a couch-tv Studio design on the TV (you press OK first). Needs a little setup (The couch-tv TV app or a computer at home running couch-tv, for your agent to reach the TV; An AI app that can use tools (MCP), such as Claude Desktop, Claude Code or Cursor, or any program on your network). - Words on a TV cannot hold digits, links, emails or phone numbers. The TV hides them. ## Send it to your TV ### Send a design to your TV with a code Source: https://couchtv.joshuaseage.com/help/send-code/ Press Send, then Make my code. On the TV: Home settings, couch-tv Studio, Get a design, and type it. 1. In couch-tv Studio press Send to my TV, then Make my code. 2. On the TV, open Home settings (the gear tile), then couch-tv Studio. 3. If it is off, press Turn on couch-tv Studio. Nothing changes until you choose a design. 4. Press Get a design and type the code with the remote. 5. The TV shows the design and asks Use this design? Press Yes. - The short code works once, for 30 minutes. The QR code holds a long code that works for up to 7 days. - A design nobody collects is deleted after 24 hours. - This site never connects to your TV. The TV fetches the design by code. - Get a design needs couch-tv 0.13 or newer on the TV. Q: How long does the code last? A: The short code works once, for 30 minutes. The long code in the QR works for up to 7 days. Q: Does the site connect to my TV? A: No. Your TV fetches the design by its code and asks before using it. Q: Can I undo it? A: Yes. Home settings, couch-tv Studio, Remove the design I got, or Back to my classic home. ### Send with a QR code or from your phone Source: https://couchtv.joshuaseage.com/help/send-qr/ Design on your phone and send from there. The QR holds a long code that works on several TVs for 7 days. 1. Design on your phone, then press Send to my TV and Make my code. 2. Type the short code on the TV, as in Send with a code. 3. The QR code holds the long code, which starts with CTV1. Scan it with your phone to keep it. 4. The long code works in Get a design on any of your TVs for 7 days. The short one works once. - The QR is made in your browser. Nothing else sees it. - The gallery's Sell page also takes a TV code, so you can sell a design you sent. ### From the TV: get a design, or share yours Source: https://couchtv.joshuaseage.com/help/send-from-tv/ Get a design types a code on the TV. Open this home in couch-tv Studio sends what the TV shows now to couch-tv Studio on your phone. 1. On the TV, open Home settings, then couch-tv Studio. 2. Get a design: type a code from couch-tv Studio or the gallery. 3. Open this home in couch-tv Studio (Share this home on 0.13.0 to 0.13.2): the TV shows a code and QR. Open couch-tv Studio on your phone and type it under Already use couch-tv from GitHub? 4. Change it on your phone, then send it back with a new code. - It removes names, photos, places, Wi-Fi details, addresses, keys and calendar links before it sends anything. If it finds anything private it sends nothing. ### Guest designs: what to set on the TV Source: https://couchtv.joshuaseage.com/help/guest-tv/ The design brings the look. The guest's name, your bookings calendar and your guest Wi-Fi are set on the TV, so they never leave your home. 1. On the TV, press the gear in the corner of your design (or hold OK, then choose Settings). Choose Home settings, then couch-tv Studio, then At home. 2. Under Guests, type the guest's name in Guest name. The Welcome greets them by it until you change it. 3. Or link your bookings: choose Add a bookings calendar link and paste your Airbnb, Booking.com or VRBO calendar link. The easy way to paste a long link is your phone remote's Type on the TV. 4. Airbnb's calendar has no names in it: type each guest's first name once under Next guest. 5. Add your guest Wi-Fi in the same place, under Guest Wi-Fi. The design shows its QR code for guests to scan. - Your phone remote's Type on the TV is the easy way to paste a long calendar link. ### Send it with your AI Source: https://couchtv.joshuaseage.com/help/send-ai/ With couch-tv Studio connected, ask your AI to send it. It gives you a code to type on the TV. 1. Connect couch-tv Studio to your AI (see Connect your AI). 2. Ask for the design, then say send it to my TV. 3. Your AI gives you a short code, a long code and a QR. 4. On the TV: Home settings, couch-tv Studio, Get a design, and type it. - Some ChatGPT plans only allow tools that read. Then ask it to open the design in couch-tv Studio and press Send to my TV there. ### Go back to your old home Source: https://couchtv.joshuaseage.com/help/undo-home/ Home settings, couch-tv Studio, Back to my classic home. Your design is kept for later. 1. On the TV, open Home settings, then couch-tv Studio. 2. Remove the design I got goes back to the home as it was. 3. Back to my classic home turns couch-tv Studio off in one step and keeps your design for later. 4. On Google TV, Undo in the Setup app puts Google's own home back. - Holding Back for five seconds also brings the normal home back. ## The gallery ### Find a design in the gallery Source: https://couchtv.joshuaseage.com/help/gallery-browse/ Home screens people made. Filter by room, look, price and how smooth it is on your TV. 1. Open the gallery. 2. Pick what the TV is for: living room, bedroom, guests, kids, smart home and more. 3. Filter by look, price (Free only) and TV speed. 4. Open a design to see it drawn by the real TV home. Like or Save it for later. - The couch-tv starters are free, with no account. Some designs, ours and other creators', cost a little and are bought once. - Designing your own and sending it to your TV is always free. ### Buy a design Source: https://couchtv.joshuaseage.com/help/gallery-buy/ Press Buy, pay once on Stripe's page, and it is yours on every TV you own. 1. Open the design and check its speed line: it says which TVs run it smoothly. 2. Press Buy. Sign in with your email if asked (we email you a link, no password). 3. Pay on Stripe's own page with a card, Apple Pay or Google Pay. We never see your card. 4. Back on the design, press Get on my TV for a code. - Prices are in Australian dollars. Your bank may show it in your own money. - You may use it on your own TVs and change it for them, but not share or sell it. - Buyers can also download the design file and press Change it for my TV. Q: Do I need an account to buy? A: Yes, so the design stays yours on every TV. We email you a sign in link, no password. Q: Is my card safe? A: You pay on Stripe's own page. We never see or store your card number. ### Put a gallery design on your TV Source: https://couchtv.joshuaseage.com/help/gallery-to-tv/ Press Get on my TV for a code, then type it on the TV in Get a design. 1. Open the design in the gallery (on your phone is fine). 2. Press Get on my TV. You get a short code and a QR. 3. On the TV: Home settings, couch-tv Studio, Get a design, and type the code. 4. The TV asks Use this design? before anything changes. 5. Want to change it first? Press Change it for my TV (or Remix in the designer), then send it from there. - You can get a new code whenever you like, for any of your TVs. - Your TV needs couch-tv, which is free. ## Sell your designs ### Sell a design Source: https://couchtv.joshuaseage.com/help/sell-start/ Make an account, set up Get paid, then share your design with a price. A person checks it before it goes on sale. 1. Make your design in couch-tv Studio. 2. Open Sell your designs in the gallery and make an account (we email you a link). 3. On your account page, set up Get paid once. 4. Press Sell a design. Bring it from this browser, a TV code or a design file. 5. Name it, pick a category, set your price (A$1.99 to A$100) and press Share it. - We keep 20% of each sale. You keep 80%, less Stripe's card fee. There is no minimum fee. - Stripe's fee depends on your country. An estimate for a seller in Australia: on an A$4.99 sale paid with an Australian card you get about A$3.60, and on A$1.99 about A$1.25. Overseas cards cost a little more. Stripe's rates are on Stripe's pricing page (https://stripe.com/au/pricing). - A person checks it first, usually within 2 days. - A free account sells 1 design. Everyone can list up to 3 new designs a week. - Every design you list is sold. Only our official designs can be free. - Already made a layout somewhere else? Upload the file (https://couchtv.joshuaseage.com/help/upload-file/) and we will check it. - Making the file with an AI tool? Point it at the design file format (https://couchtv.joshuaseage.com/help/design-format/) and its JSON Schema (https://couchtv.joshuaseage.com/help/design-format.schema.json). Q: How much can I charge? A: From A$1.99 to A$100. We keep 20% of each sale. You keep 80%, less Stripe's card fee. Q: What do I get from a sale? A: 80% of the price, less Stripe's card fee. On an A$4.99 sale with an Australian card that is about A$3.60. Q: How many designs can I sell? A: A free account sells 1. Creator (A$4.99, once) sells more. Everyone can list up to 3 new designs a week. Q: Who checks my design? A: A person looks at every design before it goes on sale, after the same safety check a TV runs. It is usually done within 2 days. ### Upload a design file Source: https://couchtv.joshuaseage.com/help/upload-file/ Already made a layout somewhere else? Upload the file and we will check it. The design file format page says exactly what the file can hold. 1. Get the file ready: a design you downloaded from couch-tv Studio, or one you or your AI wrote to the design file format. 2. Wrote it yourself or with an AI? Check it against the JSON Schema first. Most JSON tools and AI tools can do this, and it names the exact line that is wrong. 3. Open Sell your designs in the gallery, sign in, press Sell a design and choose A design file. Drop in a .json, or a .zip with your own photo in it. 4. We check it the same way as a design made in couch-tv Studio. Parts a TV cannot show, like a widget name with a typo or a link in some words, are left out, so look at the picture before you go on. 5. Want to change something first? On a computer, open couch-tv Studio, press Open a file, change it, then sell it from this browser. 6. Press Share it. A person looks at it before it goes on sale, usually within 2 days. - "The design is empty" usually means nothing in the file was a widget a TV knows. Check each widget's kind against the list on the design file format (https://couchtv.joshuaseage.com/help/design-format/) page. - The file is plain data: no code, no links. Your own photo goes beside the file, never inside it. - Making the file with an AI tool? Point it at the design file format (https://couchtv.joshuaseage.com/help/design-format/) and its JSON Schema (https://couchtv.joshuaseage.com/help/design-format.schema.json). ### Creator: A$4.99, once Source: https://couchtv.joshuaseage.com/help/creator/ Creator lets you keep more designs and sell more. One payment, no subscription. Still up to 3 new designs a week. 1. Sign in, then open Sell your designs. 2. Press Get Creator and pay A$4.99 once on Stripe's page. 3. Your account becomes Creator straight away. - A free account keeps 1 design and sells 1. - Designing and sending to your TV stay free for everyone, with no account. ### Why is my design waiting? Source: https://couchtv.joshuaseage.com/help/review/ Every design is checked before it goes on sale: first by the same safety check a TV runs, then by a person. 1. After Share it, your design says Waiting for a check. Only you and moderators can see it. 2. A person looks at it, usually within 2 days. Designs with your own photo are always looked at. 3. If it is not listed, you see why. Change it in the designer and share it again. - Waiting more than 2 days? Email info@underseage.studio with the design's name. - Not allowed: pictures you have no right to share, nudity, other people's private details, or anything pretending to be from a company. - Words on a TV cannot hold phone numbers, emails, links or addresses. ### Getting paid Source: https://couchtv.joshuaseage.com/help/payouts/ In most countries Stripe covers, Stripe pays you straight to your bank in your own money. Where Stripe does not reach, such as India, PayPal is coming soon. 1. On your account page, open Get paid and pick your country. 2. Stripe countries (Australia, New Zealand, the US, Canada, the UK, most of Europe, Japan, Singapore, Hong Kong and more): set up your own Stripe account in your country on Stripe's pages. We never see your bank details. 3. Each sale goes to your own Stripe account. Buyers pay in Australian dollars, and Stripe pays your share to your bank in your own money on its own schedule. Your Stripe dashboard shows the dates. A new Stripe account's first payout can take longer. 4. Where Stripe does not reach, such as India: we will pay you by PayPal. That is coming soon, with no date yet. Until then you can design and use your own designs free. - We keep 20% of each sale. You keep 80%, less Stripe's card fee. There is no minimum fee. - Stripe's fee depends on your country. An estimate for a seller in Australia: on an A$4.99 sale paid with an Australian card you get about A$3.60, and on A$1.99 about A$1.25. Overseas cards cost a little more. Stripe's rates are on Stripe's pricing page (https://stripe.com/au/pricing). - If a buyer is refunded, that sale's money comes back out of your Stripe balance and we give our 20% back. - You must be 18 or older to sell. - You look after your own tax on what you earn. Q: Which countries can sell now? A: Anyone 18 or older living in a country Stripe covers for us: Australia, New Zealand, the US, Canada, the UK, most of Europe, Japan, Singapore and Hong Kong. The full list is in the [seller rules](/sellers#fees), and the sell page checks your country for you. Q: Is PayPal ready? A: Not yet. PayPal is coming soon for countries Stripe does not cover, such as India. There is no date yet. Q: Do you need my bank details? A: No. We never ask for them. Stripe or PayPal keeps them. ## Design with your own AI ### Connect your AI Source: https://couchtv.joshuaseage.com/help/ai-connect/ Add one address to Claude, ChatGPT or Gemini. Then just ask it for the TV you want. 1. Copy the address https://couchtv.joshuaseage.com/mcp. 2. Claude (every plan): Customize, Connectors, +, Add custom connector. Paste it, no sign in. 3. ChatGPT (paid plans): Settings, turn on Developer mode, then add a custom MCP server with No authentication. 4. Gemini (US only for now): Settings, Connected Apps, Add a custom app. 5. Ask: Design my bedroom TV, black, a soft clock and the date. - No account needed. Your AI sees the design, nothing else, and never connects to your TV. Q: Which AIs work? A: Claude on every plan, ChatGPT on paid plans, Gemini in the US for now, plus Cursor, VS Code and any app that takes a remote MCP address. Any other chatbot works with the copy and paste prompt. Q: Does it cost anything? A: Not from us. It uses your own AI account. ### Use any chatbot, no connector Source: https://couchtv.joshuaseage.com/help/ai-prompt/ Copy our prompt into any chatbot, free ones too. Paste what it gives back into couch-tv Studio. 1. On the AI page, press Copy the prompt and paste it into your chatbot. 2. Answer its three questions: the room, the feel, what you want on screen. 3. Copy the design it gives back (it starts with {). 4. In couch-tv Studio press Design with your AI, paste it into the paste box, and check it on the real TV home. ### Sell a design your AI made Source: https://couchtv.joshuaseage.com/help/ai-sell/ Ask your AI to open it to sell. You check it, then sell it from your own account. Any Google Font is fine. 1. Ask your AI: open it in couch-tv Studio to sell. It gives you a link. 2. Open the link, check the design and change anything. 3. Press Sell in the gallery on a computer, or on a phone open Sell your designs and bring it from this browser. 4. Sign in, set your price and press Share it. A person checks it before it goes on sale. - Your AI can never list or sell anything for you. Only you can, from your own account. - AI designs can use any Google Fonts family by name. TVs get the font through our site. - Buyers get the design file too. - Already made a layout somewhere else? Upload the file (https://couchtv.joshuaseage.com/help/upload-file/) and we will check it. - Making the file with an AI tool? Point it at the design file format (https://couchtv.joshuaseage.com/help/design-format/) and its JSON Schema (https://couchtv.joshuaseage.com/help/design-format.schema.json). ## Account, refunds and privacy ### Do I need an account? Source: https://couchtv.joshuaseage.com/help/account/ Not to design or send to your TV. Only to save designs, buy one or sell one. No password: we email you a link. 1. Press Sign in in the gallery, or My designs in the designer. 2. Type your email. We send you a link, so there is no password. Or use Google. 3. Open the link on the same phone or computer. - A free account keeps 1 design and sells 1. - couch-tv Studio is for people 13 and over. Selling is for 18 and over. ### Refunds Source: https://couchtv.joshuaseage.com/help/refunds/ Within 7 days, if you have not put the design on a TV yet, press Refund me. After that, ask and a person decides. 1. Open the design you bought in the gallery. 2. Press Refund, say what went wrong and press Refund me. 3. Already put it on a TV? Press Ask for a refund. If it does not work on your TV, you get your money back. We reply by email. 4. The money goes back to your card, usually in 5 to 10 days. - Your rights under Australian Consumer Law are not limited by this. - Questions about a payment: reply to the receipt Stripe emails you. Q: How long do I have to get a refund? A: 7 days from buying. If you have not put it on a TV yet, Refund me works straight away. Q: When does the money come back? A: Usually in 5 to 10 days, to the card you paid with. ### Report a design Source: https://couchtv.joshuaseage.com/help/report/ Every design's page has Report this design. A person reads every report. 1. Open the design and press Report this design under the buttons. 2. Pick what is wrong. If it uses your photo or work, choose It uses my picture or work. 3. Add what we need and send it. Anyone can report, signed in or not. ### Privacy Source: https://couchtv.joshuaseage.com/help/privacy/ Your design stays in your browser until you send it. Sent designs are deleted when the code runs out. No ads or trackers. 1. While you design, everything stays in your own browser. 2. When you send, we keep the design and photo only until the code runs out, then delete them. 3. Photos are redrawn first, which removes hidden details like where they were taken. 4. To see, change or delete your account, email josh@underseage.studio. We reply within 30 days. - This help and its assistant run in your browser. What you tap or type stays there. We only count that help was opened, as a daily number with nothing about you, and not at all if your browser asks not to be tracked. ## Something is not working ### The code does not work Source: https://couchtv.joshuaseage.com/help/code-fails/ Each short code works once, for 30 minutes. Make a new one and type it again. 1. Make a new code: press Send to my TV, then Make my code again. 2. Type it carefully. Capitals and spaces do not matter. 3. Typing on several TVs? Use the long code from the QR (it starts with CTV1). It works for 7 days. 4. Check the TV is online: open any app that needs the internet. ### There is no Get a design on my TV Source: https://couchtv.joshuaseage.com/help/no-get-design/ Your TV needs couch-tv with couch-tv Studio in Home settings. That is in couch-tv 0.13 and newer. 1. Check couch-tv is your TV's home (Get it on your TV has the steps). 2. On the TV, open Home settings and look for couch-tv Studio. 3. Not there? Your couch-tv is older: update couch-tv on your TV. Your settings stay. 4. On a Samsung, couch-tv Studio needs couch-tv 0.13.4 or later, and a Samsung does not update itself: download the newest couch-tv-samsung-setup.zip and run it again (Samsung help). Your settings stay. 5. Until then, press Save a copy (file) in couch-tv Studio to keep your design for later. ### A widget shows a setup card Source: https://couchtv.joshuaseage.com/help/setup-card/ It needs one thing on your TV first, like your town or your photos. Press OK on the card for the steps. 1. On the TV, move to the widget and press OK. It shows the steps for your TV. 2. Or tap the widget in couch-tv Studio: its panel says what it needs. 3. A widget marked Not on your TV cannot show on that kind of TV. Swap it for another. ### My TV feels slow Source: https://couchtv.joshuaseage.com/help/slow-tv/ Keep the speed bar on Smooth: fewer widgets, solid panels instead of frosted, and one photo. 1. Open your design and tap the speed bar at the top. 2. Press Make every frosted panel solid. It helps most on slow TVs. 3. Remove widgets you do not need. 4. Send the design to your TV again. ### The phone remote Source: https://couchtv.joshuaseage.com/help/phone-remote/ Open Couch TV on the TV, then point your phone's camera at its QR code, or open the address it shows. Type its code. Same Wi-Fi for both. 1. Point your phone's camera at the QR code on the Couch TV screen, open the page, and type the 6 digit phone code. 2. Add the page to your phone's home screen. That is your remote. 3. Arrows and typing need one more switch: open the same address with /setup on the end. 4. Code gone? Press New phone code on the Couch TV screen. - Turning the TV on from your phone needs a computer left on at home. - No QR code on the Couch TV screen? Your couch-tv is older: open the address it shows instead, like http://192.168.1.20:5400. ### Still stuck? Source: https://couchtv.joshuaseage.com/help/contact/ Ask your own AI with our help pages, or ask on GitHub. Account and privacy questions go to our email. 1. Press Ask your own AI in the Help panel. It copies a prompt with links to these pages. 2. Paste it into ChatGPT, Claude or Gemini and add your question. 3. Still stuck? Ask on GitHub: github.com/Seagey/couch-tv/issues. 4. Account, payment or privacy questions: josh@underseage.studio. ## Words we use Source: https://couchtv.joshuaseage.com/help/words/ - couch-tv: The free app on your TV that shows your design as its home screen. - couch-tv Studio: This site. Make a design, send it to your TV, or buy and sell designs in the gallery. - Design: A whole home screen for your TV: the background, the widgets and the apps. - Starter design: A free design from us to start from. You can change anything in it. - Widget: One thing on the screen, like a clock, the weather or a row of apps. - Speed bar: How hard your design makes your TV work: Smooth, Fine, Getting slow or Too slow. An estimate, not a test. - Widget grid: Widgets snap into neat rows and columns, like the icons on a phone. - Free: A layout where words and shapes can sit anywhere inside the safe area, not just on the grid. - Layers: A list of everything on your screen, top to bottom. Handy for picking something small. - Safe area: The middle of the screen that every TV shows. Some TVs cut off the edges outside it. - Try it with the remote: Drive your design with the arrow keys and Enter, the way a TV remote does. - Panel: The box behind a widget: Glass, Solid, Colour, Paper or None. - Glass: A frosted panel that blurs the picture behind it. Pretty, but the slowest thing a TV draws. - Solid: A plain panel with no blur. Much easier on a slow TV. - Smart stack: Up to 10 widgets of one size that take turns in one place. - Pin: Keeps a widget still while you move the others. - Swap: Changes a widget for another one in the same place. - Setup card: What a widget shows on the TV until it has what it needs, like your town. Press OK on it for the steps. - Home settings: The gear tile on your TV's couch-tv home. Your town and couch-tv Studio are in there. - Code: A short code you type on the TV to get a design. It works once, for 30 minutes. - Long code: The code inside the QR. It starts with CTV1 and works on any of your TVs for 7 days. - Get a design: Where you type a code on the TV: Home settings, then couch-tv Studio. - Setup app: A free app for a Mac or Windows computer that puts couch-tv on Google TV and Fire TV. - Downloader: A free TV app, the orange one by AFTVnews, used to put couch-tv on Android TV with a number. - Developer mode: A hidden TV setting that lets you add apps from outside the TV's own store. - Google TV and Android TV: Google's systems for TVs, on Sony, TCL, Philips, many Hisense and others, and on Google TV boxes. - Fire OS: The system on Amazon's Fire TV sticks and Fire TV smart TVs. - Tizen: The system on Samsung TVs. - webOS: The system on LG TVs. - VIDAA: The system on many Hisense TVs. - Home Assistant: A free smart home app you run at home. The Aircon and Scenes widgets need it. - Gallery: Designs people share. Some are free, some cost a little and are bought once. - Official: A design made by the couch-tv Studio team, not by another seller. - Creator: A one off A$4.99 upgrade that lets you keep and sell more designs. No subscription. - Get paid: On your account page: where you set up how your sales are paid to you. - Design file: A design saved as a file: a .json, or a .zip with your own photo. Save a copy, open or upload it. - JSON Schema: The exact rules a design file follows, for people and AI tools that write one. - Design with your AI: The designer button that copies a prompt for your own AI, then opens the design it gives back from the paste box. - Connector: An address you add to Claude, ChatGPT or Gemini so it can make designs with couch-tv Studio.