Picture Window guide
There are two ways to set it up. Either way it’s done once, and after that the TV looks after itself.
- Ask your AI agent. If you use an AI coding agent with access to your computer’s terminal, like Claude Code, Codex or Gemini CLI, paste in one prompt and it does everything: Picture Window first, then the MTD etc. version of CleanYourTV’s home screen (step 01) showing the same photos. It explains each step and asks before it changes anything on the TV, and you can tell it to skip the new home screen.
- Do it yourself. Set up the MTD etc. version of CleanYourTV for your TV model (step 01), then follow the steps below. Picture Window itself takes about 15 minutes in a terminal.
You need:
- A Google TV or Android TV running Android 8 or newer. Roku, Fire TV, Samsung and LG TVs can’t run it. On a Roku TV, plug a Google TV box into a spare HDMI port.
- A computer (Mac, Linux, or Windows with Git Bash or WSL) on the same Wi-Fi as the TV.
- Ideally 4 GB free on the TV. Picture Window keeps up to 2 GB of photos and always leaves 2 GB free.
02 · Install Picture Window
Option A: ask your AI agent
- Open the setup prompt on GitHub and copy everything in the grey box.
- Open your agent in a new, empty folder, for example one called
picture-window, and paste it in. - Follow along. It tells you what to press on the TV, shows you what each step will do, and waits for your OK before changing anything.
The prompt covers steps 01 to 03, so you can skip ahead to step 04 when it’s done. The new home screen takes longer than Picture Window and needs a few more tools on your computer; the agent tells you what and asks first.
The prompt lives in the app’s repository, so it always matches the latest version of the app.
Option B: do it yourself
Turn on debugging on the TV
- Settings → System → About. Scroll to Android TV OS build and press OK on it seven times, until the TV says you’re a developer.
- Go back to Settings → System → Developer options and turn on USB debugging, plus Network debugging if your TV has it.
- Find the TV’s IP address under Settings → Network & Internet → your Wi-Fi network. It looks like
192.168.1.50.
Get the tools
- adb, Android’s command-line tool. On a Mac:
brew install android-platform-tools. On Windows or Linux, download Android SDK Platform-Tools. - The setup scripts: download picture-window-tv as a zip from the green Code button and unzip it, or
git cloneit. - The app: download
picture-window-<version>.apkfrom the latest release into that folder.
Run the setup
In a terminal (on Windows, Git Bash or WSL), in that folder, with your TV’s IP address:
TV_HOST=192.168.1.50 scripts/setup-tv.sh --dry-run --apk picture-window-*.apk # shows what it will do
TV_HOST=192.168.1.50 scripts/setup-tv.sh --apk picture-window-*.apk # does it
The first time, the TV asks “Allow USB debugging?”. Tick Always allow from this computer, choose Allow, and run the command again.
The script backs the TV up first, installs the app and makes it the screensaver. The photos, about 2 GB, arrive over the next 10 to 30 minutes, depending on your connection. Until then the screensaver shows the ones it has.
03 · Bring the photos onto your home screen
CleanYourTV’s home screen can show the same photo as the screensaver, with the same credit. That setting, photo_source, is in the MTD etc. version of CleanYourTV from step 01: corinnekunze/cleanyourtv. If you set up the original CleanYourTV instead, reinstall its home screen from the MTD etc. version first.
Option A: ask your AI agent. The setup prompt already did this, unless you told it to skip the new home screen. To add it later, paste the prompt again and say you only want Part 2.
Option B: do it yourself. The MTD etc. version comes with a ready-made theme for this. Push it from the CleanYourTV folder:
TV_HOST=192.168.1.50 tools/theme.sh themes/picture-window
If it says run: python3 -m venv tools/venv …, run that line once to set up its Python tools, then push the theme again.
Home restarts and picks up the current photo, slightly dimmed, with a soft shadow under the clock and app names so they stay readable over bright photos. It follows the screensaver from then on, and the launcher itself stays offline. If Picture Window has no photo yet, Home shows its normal background and checks again later.
04 · Choose your screensaver settings
- How long the TV waits before the screensaver starts is a TV setting, under Settings → System → Ambient mode (or Energy) on most Google TVs.
- The clock: open Picture Window from your apps to turn the clock on or off, and see how many photos it has.
- New photos: on the same screen, untick Get new photos each month to keep the photos you have instead. The TV stops downloading and keeps reshowing what’s on it. Photos taken out of the feed still leave at the daily check, and you still hear about app updates. Tick it again to get new photos the same day.
- A new photo shows every 3 minutes, never the same one twice in a row.
On Google TV, Picture Window won’t appear in the screensaver menu. That’s expected; the setup set it for you. Choosing another screensaver there switches it off.
When you’re done, turn USB debugging (and Network debugging) back off under Developer options. Picture Window doesn’t need it.
05 · Check photo and app updates
- Photos: about 350 new ones arrive each month on their own, unless you’ve turned new photos off. The TV checks once a day, shows new photos before repeats, and keeps showing the ones it has if the internet goes down.
- The app: when there’s a new version, open Picture Window and press Update, then confirm Android’s prompt. The first time, Android asks you to allow Picture Window to install apps. Your photos and settings stay, and no computer is needed.
06 · Troubleshoot or restore
| What you see | What to do |
|---|---|
| “Can’t reach the TV” | Check the IP address, wake the TV (it drops off the network in standby) and check debugging is on. |
| “The TV is asking to allow USB debugging” | Accept the prompt on the TV, tick “Always allow”, and run the command again. |
| “A copy signed with another key is installed” | An older or test copy is on the TV. Run the setup again with --replace. Its photos download again. |
| “This TV runs Android SDK …” | The TV’s Android is too old for Picture Window. Nothing was changed. |
| The screensaver says it’s downloading photos | Give it a few minutes on its first day. |
To undo everything, turn debugging back on and run:
TV_HOST=192.168.1.50 scripts/restore-tv.sh --dry-run # shows what it will put back
TV_HOST=192.168.1.50 scripts/restore-tv.sh
That puts the TV back the way it was when Picture Window was installed: its own screensaver and settings, and Picture Window uninstalled. If the setup prompt did both parts, it undoes the home screen too: the apps it switched off come back on, the TV’s own home screen returns and CleanYourTV’s is uninstalled.
If you set up CleanYourTV yourself before Picture Window, undo it with CleanYourTV’s own restore script, from its folder and with the list you used: TV_HOST=192.168.1.50 tools/restore.sh examples/<your-tv>/debloat.txt.
Without a computer, you can also pick Google’s screensaver again under Settings → System → Ambient mode and uninstall Picture Window under Settings → Apps.
Want your own feed?
The feed is open source. To run your own, with your own subjects and rules, fork corinnekunze/picture-window, turn on GitHub Pages and follow “Setting up a copy” in its README. Then set Feed URL in Picture Window’s settings to your feed’s index.json.
Questions or problems?
Stuck on a step, found something wrong in this guide, or just want to say how it went? Email me at hello@mtdetc.com. Telling me which step you were on and what you saw helps.
Build notes
If this helped, get new projects, guides and free files by email, about once a month.