How to Set Up IPTV on Android TV: Xtream Codes Step-by-Step

Want IPTV on the big screen without fighting the on-screen keyboard? Set up GridStreamr on Android TV or Google TV the way it was designed: add Xtream on your phone, build a Smart Collection, then QR-link the TV and lean back. Important: the Android TV app only watches Smart Collections — not your raw Xtream or M3U source tree.

What you'll need

• An Android TV or Google TV device (Chromecast with Google TV, Nvidia Shield, Sony/TCL/Hisense Google TV, and similar).
• GridStreamr on the TV from Google Play, plus GridStreamr on your phone (iPhone or Android) for QR sign-in.
• Authorized Xtream Codes credentials (host, username, password) — or an M3U URL if that's what you have.
• At least one Smart Collection with channels in it — required; Android TV won't show the raw source.
• A solid network: 5 GHz Wi‑Fi or Ethernet beats congested 2.4 GHz for HD/4K.

The flow that works

Phone first, TV second. Sources live on the phone; the TV only opens Smart Collections. Typing a long Xtream host with a D-pad is optional pain — skip it.

1. Phone: install GridStreamr → add Xtream (or M3U) → build a living-room Smart Collection → map EPG.
2. TV: install GridStreamr from Play → scan the QR with your phone → open the synced Smart Collection → watch.

Step 1: Prepare Xtream on your phone

On iPhone or Android, open GridStreamr and tap Add Source → Xtream. Paste host, username, and password. We'll pull Live TV, Movies, and Series on the phone. Then create a Smart Collection for the living room ("Living Room" or "Sports TV") and add only the channels you'll actually flip through with a remote — this step is mandatory for Android TV. Heart favorites so they surface first on the TV grid.

For the guide: keep Xtream provider EPG when it's solid, or map channels to Global EPG inside the Smart Collection. On Premium, AI Auto-match can suggest mappings — you review before anything saves. Don't expect a perfect guide the moment you connect a source.

Step 2: Install GridStreamr on Android TV

1. On the TV, open Google Play Store.
2. Search GridStreamr and install.
3. Launch the app — you'll see a QR code for account linking.
4. Prefer Play Store installs so updates stay easy.

Step 3: Link your phone with QR

On the phone, open GridStreamr signed into the same account that owns your collections. Scan the QR on the TV (or use the on-screen pairing code if glare makes scanning hard). When linking finishes, you should see your Smart Collections on the TV within moments — that's the only IPTV library the TV app shows.

Step 4: Watch from a Smart Collection

1. Open your living-room Smart Collection on the TV — there is no separate "all channels from my Xtream" screen.
2. Browse categories or favorites inside that collection.
3. Open the guide and confirm Now/Next looks right on a few channels.
4. Start a known-good channel (news or sports you trust) and check audio (TV speakers vs soundbar).

Step 5: Remote-friendly habits

• Keep the living-room collection short — remotes hate 40-page channel lists.
• On Premium, use the full-day EPG timeline for schedule browsing from the couch.
• Premium TimeShift works when your Xtream provider exposes archive — open catch-up from the player, scrub, then return to live.
• Put adult or warehouse collections behind a parental PIN before kids get the remote.

Premium required on Android TV

• Android TV requires Premium — subscribe on iOS or Android first, then QR-link the TV. Entitlement syncs from your phone subscription.
• Premium includes unlimited collections, full-day EPG, TimeShift, Jellyfin, and Home DVR control from the same account.

Troubleshooting on GridStreamr Android TV

1. Buffering on 4K: move the TV to Ethernet or strong 5 GHz before changing anything else.
2. Phone plays fine, TV doesn't: check the TV's Wi‑Fi band or try a wired adapter.
3. TV looks empty: confirm a Smart Collection exists with entries — Android TV never shows the raw source.
4. Guide times look wrong: fix timezone, then remap EPG in the Smart Collection on your phone.
5. Black screen on one channel: try another channel in the same collection — if only one fails, it's usually that stream, not the app.

Once the QR link works and your living-room Smart Collection is trimmed, Android TV becomes the easy screen in the house — same account, collections-only lean-back, remote-ready.