GridStreamr logo
GridStreamr logo

GridStreamr

IPTV OS

Download for iOSDownload for AndroidDownload for Android TVworkspace_premiumTry Premium Free (7 days)
Documentation

Master your GridStreamr experience.

Become an IPTV power user. Learn how to connect sources, build lightning-fast smart collections, and share your IPTV setup securely with your community.

Step 1

Getting started.

GridStreamr is designed to be cross-platform and intuitive. Follow these three steps to begin your journey.

Download from App Store or Google Play

Get GridStreamr from the App Store for iOS or Google Play for Android. Sign in with Apple, Google, or email to get started.

Choose your Theme

Select between light and dark mode to match your preference. Your theme choice syncs across all your devices automatically.

Configure your @username

Set up your unique username or user tag in the side menu Settings. This identifier is essential for other GridStreamr users to find you and share curated content with you directly.

Add your first playlist

Connect your first playlist by adding an Xtream Codes account or importing an M3U playlist. Free tier includes 1 Xtream account and 1 playlist to get you started.

TV

Sign in on Android TV.

GridStreamr for Android TV uses your phone to complete account sign-in: the TV shows a QR code, and the GridStreamr mobile app on the same account authorizes the TV. Typing passwords with a remote is not required.

qr_code_scanner
01

On your Android TV

  1. Open the GridStreamr app on your Android TV or Google TV device.
  2. From the sign-in screen, note the pairing code and the QR code (they encode the same device ID).
smartphone
02

On your phone

  1. Install GridStreamr on your iPhone or Android phone and sign in with the same GridStreamr account you want on the TV.
  2. Scan the TV's QR code with your phone camera (or open mylists.gridstreamr.com/activate and enter the on-screen code manually).
  3. When the browser redirects into the GridStreamr app, confirm the prompt to authorize this TV. Your TV will create its own session and finish signing in.
info
Phone not signed in yet?
If the link opens the app before you are logged in, sign in on the phone first, then scan the QR code again or revisit the activation page with the same code so the app can complete authorization.

Don't have GridStreamr TV yet?

Get it on Google Play for Android TV
Step 2

Manage your sources.

GridStreamr supports Xtream Codes and M3U URLs. Import your IPTV playlists and keep them all in one beautiful, organized library.

api
01
Free: 1 | Premium: ∞

Xtream Codes API

Connect via Host URL, username, and password. GridStreamr uses the Xtream API to fetch VOD metadata and real-time XMLTV EPG markers.

link
02
Free: 1 | Premium: ∞

Remote M3U Playlists

Paste a remote M3U8 link or upload local .m3u files. Streams are parsed for group-titles and automatically mapped to EPG channels.

public
03
50,000+ Channels

GridStreamr Global EPG

Exclusively for Smart Collections or reconfiguring existing XTREAM lists, access the new Global EPG source featuring 50,000+ integrated providers. Get real-time personalized alerts for live games and favorite shows.

search
04
Instant feedback

Fast Search

Search across all your connected sources simultaneously. Find the movie or channel you want in seconds, no matter which playlist it's in.

Step 3

The power of Smart Collections.

Mix and match entries from multiple sources to build your perfect custom lineup.

See it in action

Three quick walkthroughs that mirror exactly how Smart Collections behave inside the GridStreamr mobile app. Each one auto-plays while you read.

9:41
signal_cellular_altwifibattery_full

Smart Collections

1

  • Sports Hub

    38Live4Movies0Series
Step 1

Create a Smart Collection

Spin up a fresh collection in three taps. No setup, no syncing, ready instantly.

  1. 1

    Tap the + button

    Open the Smart Collections page and tap the mint + in the top right.

  2. 2

    Name your collection

    Pick something memorable, the name is just for you. You can edit it any time.

  3. 3

    Done, start adding entries

    GridStreamr drops the new collection at the top of your list, ready to fill.

9:41
signal_cellular_altwifibattery_full

Live TV

  • sports_soccer

    Sports Live HD

    Premier League · Live

  • newspaper

    News 24

    World Briefing

  • local_movies

    Cinema HD

    Now Showing

  • explore

    Discovery+

    Wild Earth

Step 2

Add entries with a long press

Build your collection from any source. Long-press to multi-select, then add the whole batch in one move.

  1. 1

    Long-press any channel

    Hold a channel in Live TV, Movies or Series and GridStreamr enters multi-select.

  2. 2

    Tap Add to Smart Collection

    The glass bulk-actions bar slides up. Pick the primary action.

  3. 3

    Choose the collection

    Tick one or more Smart Collections, tap Add. GridStreamr confirms with a snackbar.

9:41
signal_cellular_altwifibattery_full

Smart Collections

3

  • Family Hub

    147Live1.2KMovies380Series
    schedule2m ago

  • Sports Hub

    38Live4Movies0Series
Step 3

Share with a friend, securely

Send any Smart Collection to another user with a single @handle. Virtual credentials keep your main login safe.

  1. 1

    Tap the three-dot menu

    GridStreamr opens a small menu with the only action you need here: Manage shares.

  2. 2

    Open Manage Shares

    The shares page slides in. See active shares, expiry windows, and export options.

  3. 3

    Send to an @username

    Type a friend's handle. Virtual credentials keep your main login safe.

add_circle
01

Create your Smart Collection

You can create the Smart Collection first or do that on the go the first time you select entries to add to it.

playlist_add
02

Add entries

Select channels, movies, or series from any connected source to add to your Smart Collection. Use long press on any category, channel, movie, or series to quickly add it. You can add entries from multiple sources into one unified collection.

tune
03

Customize & EPG Sync

Rename and reorder channels and categories, update logos and use the 'Manage EPG' option to assign GridStreamr Global EPG sources to your channels, ensuring you always have the most accurate program information.

ios_share
04

Share your collection

Generated secure GridStreamr XTREAM URLs work in VLC, Kodi, or TiviMate. Your Smart Collection is compatible with any player supporting Xtream formats. You can also share it directly with other GridStreamr users via their @username for one-tap setup.

info
TMDB & OpenSubtitles integrations (Premium)
Connect your own TMDB API key to enrich movies and series in Smart Collections with posters, descriptions and ratings. Connect your OpenSubtitles credentials to search and download subtitles directly inside the player. Both are Premium features. See the Integrations & Player Settings section for full step-by-step instructions.
lightbulb
Pro tip
By swiping left on the list entries, you can rename categories and channels in your Smart Collection to make them uniquely yours. The changes only affect your curated collection, not the original source.
lightbulb
Quick add with long press
Use long press on any category, channel, movie, or series from any source to quickly add it to your Smart Collection. This streamlined workflow makes building your perfect lineup faster and more intuitive.
Step 4

Secure & Flexible Sharing.

Share your custom curation with others while keeping your main credentials private.

badge
01

Configure your @username

Set up your unique username or user tag in the side menu Settings. This identifier allows other GridStreamr users to find and share content with you directly. Your username becomes your sharing address for seamless collaboration.

person_add
02

Direct User Sharing

1. Configure your unique @username in Settings (side menu). 2. Go to your Smart Collection → Manage Shares. 3. Type the recipient's @username. 4. They'll receive a real-time notification and automatic configuration!

notifications_active
03

Real-time notifications

When someone shares a Smart Collection with you, you'll receive an instant push notification. Tap the notification to automatically add the shared collection to your list. You can also configure personalized EPG notifications for your favorite programs!

public
04

Universal Reach - External Players

Your curated Smart Collections work with any external media player that supports XTREAM Codes. Share with friends who use VLC, Kodi, TiviMate, or any other compatible player. Your collections are accessible everywhere!

shield
05

Secure by design

Shares use virtual credentials. Your main line username and password are NEVER exposed to the people you share with.

schedule
06

Flexible time limits

Set shares to expire in 24 hours, 7 days, any custom duration, or keep them forever. You can revoke any share instantly with one tap.

Step 5

Your Media Library.

Live TV, Movies, and Series organized for a premium viewing experience.

live_tv
01

Live TV & Guide

Browse categories or use the full-screen player. Free: Current/Next info. Premium: Full timeline view of the day's programming. Premium also unlocks TimeShift: browse past programmes and watch them on demand from the player when your Xtream provider exposes a TV archive for that channel.

movie
02

Movies & Series

Enjoy rich metadata, posters, and season/episode organization. Resume watching any title across all your synced devices.

favorite
03

Favorites

Heart your top picks. Favorites grouped at the top of your list for instant access. Highly optimized for fast channel switching.

settings_suggest
04

Advanced Player (Premium)

Select from multiple audio tracks and subtitle languages. HD playback with automatic quality adjustment for patchy networks.

lightbulb
Account Sync
Your Favorites and Continue Watching lists are synced to the cloud. Start a movie on your iPhone and finish it on your Tablet without missing a beat.
info
TimeShift (Premium)
Browse and play past broadcasts from the live TV player: open the TimeShift sheet, pick a day within your archive window, and watch in the same player with back-to-live when you finish. Availability and how deep the archive goes are set by your IPTV provider—not GridStreamr.
Step 6

EPG Notifications Setup.

Never miss an important match or show again. Premium users can configure personalized alerts directly from the mobile app.

tune
01

Define Preferences

In the mobile app, navigate to EPG settings to add your favorite sports teams or specific program titles to your notification preferences.

notifications_active
02

Real-Time Alerts

GridStreamr monitors your customized global EPG catalog and will send you a push notification when a matching program is about to start.

lightbulb
Premium Feature
EPG Notification Alerts require an active Premium subscription. The notifications are powered by our massive 50,000+ channel Global EPG catalog to guarantee accuracy.
Step 7
workspace_premium

Premium unlocks this feature

TMDB and OpenSubtitles integrations require an active Premium subscription.

Try Free

Integrations & Player Settings.

Connect your own TMDB and OpenSubtitles accounts to unlock rich metadata and on-demand subtitles, and fine-tune the player to suit your viewing preferences.

movieTMDB, Movie & Series Metadata

key
01

Get your TMDB API key

  1. Create a free account at themoviedb.org
  2. Go to your profile → Settings → API
  3. Request a Developer API key (free)
  4. Copy the API Read Access Token or API Key (v3)
settings
02

Add the key in GridStreamr

  1. Open GridStreamr and tap the side menu
  2. Go to Settings → General
  3. Tap TMDB API Key and paste your key
  4. Your key syncs securely across all your signed-in devices
auto_awesome
03

Enrich your VOD library with TMDB

Once your API key is saved, GridStreamr automatically enriches movies and series in your Smart Collections with TMDB data, posters, backdrops, descriptions, ratings, cast and crew, and release year. Here is how it works:

  1. Open your Smart Collection and navigate to Movies or Series
  2. GridStreamr matches titles from your playlist against the TMDB database automatically
  3. Matched items show rich posters, descriptions and metadata in the detail view
  4. If a title is not matched automatically, tap the item and use Search on TMDB to manually select the correct match
info
Premium feature
TMDB enrichment requires an active Premium subscription. GridStreamr is not affiliated with TMDB and does not issue API keys. You are responsible for your key and for complying with TMDB's terms of use.

subtitlesOpenSubtitles, Subtitle Search & Download

key
01

Create an OpenSubtitles account

  1. Create a free account at opensubtitles.com
  2. Note your username and password, that is all you need
settings
02

Add credentials in GridStreamr

  1. Open GridStreamr and tap the side menu
  2. Go to Settings → General
  3. Tap OpenSubtitles and enter your Username and Password
  4. Your credentials sync securely across all your signed-in devices
search
03

Search and download subtitles while playing

  1. Start playing any movie or series episode in the GridStreamr player
  2. Tap the subtitles icon in the player controls
  3. Select Search OpenSubtitles, GridStreamr queries the database using the title and episode info automatically
  4. Pick the subtitle track you want from the results list (language, number of downloads, and rating are shown)
  5. The subtitle downloads and loads instantly without interrupting playback
info
Premium feature
OpenSubtitles subtitle search requires an active Premium subscription. A free OpenSubtitles account is all you need, just your username and password. You are responsible for complying with OpenSubtitles' terms of use.

format_sizeSubtitle Appearance

tune
01

Set your subtitle size in Settings

  1. Open the side menu and go to Settings → Subtitles
  2. Tap Subtitle Size
  3. Choose your preferred size, Small, Medium, Large, or Extra Large
  4. This becomes the default size applied to all subtitle tracks across every playback session
Step 8
workspace_premium

Premium unlocks this feature

AI Enrichment requires Premium + in-app credit packs from $0.99.

Try Free

AI Live Channels Enrichment.

GridStreamr can automatically improve your Live TV channel information using GridStreamr-hosted AI and in-app AI credit packs. Standardise channel names, detect language, identify stream quality (SD, HD, FHD, 4K), classify content type, sports, news, movies, entertainment, music and more, and discover missing channel logos. Cleaner playlists, smarter search, no manual work required.

paymentsPremium & AI credits

workspace_premium
01

Get Premium and buy AI credit packs

  1. AI Live Channels Enrichment requires an active Premium subscription
  2. Purchase AI credit packs as in-app add-ons. Entry pricing starts at $0.99 USD for 500 credits (regional and store pricing may vary)
  3. When you run out of credits, the app will prompt you to top up, or you can open the paywall or store entry from the app, follow the on-screen purchase flow in the iOS or Google Play build
  4. Each enrichment run draws down your credit balance on our servers; no third-party AI account or API key is required

auto_awesomeRun channel enrichment

play_circle
02

Enrich your channels with AI

  1. Open any Smart Collection and go to the Live TV channel list
  2. Tap the ⋮ menu (top-right) and select Enrich with AI
  3. GridStreamr sends your channel metadata to GridStreamr-hosted AI; the run uses your AI credits
  4. The model returns standardised names, detected language, stream quality, content type, and discovered logos for each channel
  5. Review the suggestions, approve all at once or cherry-pick individual changes
  6. Confirmed changes apply to your Smart Collection only, your original source is never modified
info
Premium + credits
AI Live Channels Enrichment requires Premium. Usage is paid with in-app AI credit packs (e.g. from $0.99 for 500 credits); no third-party API keys are required. Pricing may vary by region and store.
lightbulb
Non-destructive by design
Enrichment suggestions are always shown for your review before anything is saved. Your original source playlist is never touched, all changes apply only to your Smart Collection copy.
HowTo

HowTo Videos.

Watch our step-by-step guides to master GridStreamr's most powerful features.

Smart Collection Creation and Editplay_arrow

Smart Collection Creation and Edit

Learn how to build and customize your perfect IPTV lineup using GridStreamr's Smart Collection feature.

Watch tutorialarrow_forward
Configure Smart Collection Sharesplay_arrow

Configure Smart Collection Shares

Master the art of sharing your curated playlists securely with other GridStreamr users and any other apps like TiviMate or IBOPlayer without sharing your main account credentials.

Watch tutorialarrow_forward
How to Add Your First Xtream Codes Sourceplay_arrow

How to Add Your First Xtream Codes Source

Step-by-step guide to connecting your IPTV provider via Xtream Codes in GridStreamr, from the panel URL to watching live TV in seconds.

Watch tutorialarrow_forward
Using TimeShift to Catch Up on Live TVplay_arrow

Using TimeShift to Catch Up on Live TV

How to use the Premium TimeShift feature to watch programmes you missed, scrub through TV archives, and jump back to live, when your Xtream provider supports it.

Watch tutorialarrow_forward
Setting Up TMDB for Richer Movie and Series Metadataplay_arrow

Setting Up TMDB for Richer Movie and Series Metadata

Learn how to connect your free TMDB API key to GridStreamr so your Smart Collections get posters, descriptions and ratings for every movie and series.

Watch tutorialarrow_forward
How to Connect Your Jellyfin Server to GridStreamrplay_arrow

How to Connect Your Jellyfin Server to GridStreamr

Step-by-step guide to adding your self-hosted Jellyfin server in GridStreamr Settings, browsing your movie and series library, playing content with full subtitle and audio track support, and resuming playback across devices.

Watch tutorialarrow_forward
Watching Multiple Streams at Once with MultiViewplay_arrow

Watching Multiple Streams at Once with MultiView

Learn how to open MultiView from the live TV player, add up to four streams, tap to focus a pane, and rearrange your layout — perfect for sports, news and multi-camera setups.

Watch tutorialarrow_forward
FAQ

Frequently Asked Questions

01

Do my friends need GridStreamr to view shared playlists?

No! While sharing with GridStreamr users via @username is the fastest and easiest way (one-tap setup), you can also generate universal M3U links or configure similar to XTREAM credentials using your Smart Collection share token. These links work in any third-party player like VLC, Kodi, or TiviMate. Your friends get the same curated experience without needing to install our app.

02

Is sharing my playlist secure?

Completely. When you share a playlist, GridStreamr creates 'virtual credentials' (a unique Share Code and a secure Token) for the recipient. These act as an Xtream Codes username and password, masking your actual IPTV service details. Your original host, username, and password are NEVER shared or exposed. You also have total control: set expiration dates, limit access to specific content, or revoke shares instantly at any time.

03

How do I configure EPG for my Smart Collection?

In your Smart Collection settings, go to 'Manage EPG'. From there, you can select the new 'GridStreamr Global EPG' source, which provides data for hundreds of channels worldwide. This ensures your curated list always has a complete and accurate program guide, separate from your original source.

04

How do I use TMDB with Smart Collections?

GridStreamr supports integration with The Movie Database (TMDB) as a Premium feature for movies and series in Smart Collections. Create a free TMDB account, generate an API key in your TMDB account settings (profile → Settings → API), then open GridStreamr Settings → General and paste your key. GridStreamr automatically matches your playlist titles against TMDB to pull posters, descriptions and ratings. If a title is not matched automatically, tap the item and use Search on TMDB to pick the correct entry manually. GridStreamr does not supply TMDB API keys; you are responsible for your key and for compliance with TMDB’s terms.

05

How do I search and download subtitles?

GridStreamr integrates with OpenSubtitles as a Premium feature. Create a free account at opensubtitles.com, then open GridStreamr Settings → General, tap OpenSubtitles and enter your username and password. While a video is playing, tap the subtitles icon in the player controls and select Search OpenSubtitles. Pick your preferred language and track from the results, it downloads and loads instantly without interrupting playback. You are responsible for your account and for compliance with OpenSubtitles’ terms.

06

How do I use AI Live Channels Enrichment?

AI Live Channels Enrichment is a Premium feature powered by GridStreamr-hosted AI. Purchase AI credit packs in the app (add-on packs from $0.99 for 500 credits; regional pricing may vary). Open any Smart Collection, go to the Live TV channel list, tap the ⋮ menu and select Enrich with AI. Enrichment uses credits and returns standardised names, detected language, stream quality, content type, and channel logos. You review suggestions before anything is applied, your original source playlist is never modified.

07

What is the difference between free and premium?

Free tier is perfect for getting started, allowing 1 Xtream account, 1 regular playlist, and 1 Smart Collection with current/next EPG info. Premium unlocks unlimited sources, full day EPG timelines, M3U file exports, Custom EPG Configuration, TMDB enrichment for Smart Collections, OpenSubtitles subtitle search, AI Live Channels Enrichment (including channel logo discovery; usage via optional in-app AI credit packs on current versions), professional playback controls like audio track selection and subtitle size adjustment, and TimeShift with live TV catch-up—where your Xtream provider supplies TV archive.

08

How does TimeShift work?

TimeShift is a Premium feature available from v2.0.6. When a live Xtream channel exposes a TV archive window from your provider's panel, tap TimeShift in the player controls to browse past programmes grouped by day, start any show from its beginning, scrub within it, then use Back to Live to return to real time. If archive is not exposed for a channel, that control stays hidden. Archive window length varies by provider—GridStreamr does not supply content or lengthen it.

09

How does 'Continue Watching' work?

The app maintains a 'Resume' list across all your devices. When you stop a movie or series on one device, it appears at the top of your list on your others. The list helps you quickly find and restart your recent media.

10

Can I use GridStreamr on my TV?

Yes! The GridStreamr Android TV app signs in by linking your phone: scan the QR code on the TV with your phone to finish activation (see the Android TV login section on this page). You can also share Smart Collections to another IPTV player on your TV using secure M3U export or XTREAM-compatible credentials. A native tvOS app is in development.

Ready to get started?

Download GridStreamr Free

Import your first Smart Collection in under two minutes. Upgrade to Premium inside the app for unlimited Smart Collections, full EPG, AI enrichment and TimeShift.

Download on the App StoreGet it on Google PlayGet GridStreamr on Google Play for Android TVworkspace_premiumTry Premium Free