GridStreamr logo

GridStreamr

IPTV OS

GridStreamr logo

GridStreamr

IPTV OS

Documentation

Master your GridStreamr experience.

Become an IPTV power user. Learn how to connect sources, build lightning-fast linked playlists, 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.

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.

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.

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.

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.

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 Linked Playlists.

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

Create your Linked Playlist

You can create the Linked Playlist first or do that on the go the first time you select entries to add to the linked playlist.

Add entries

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

Customize to your preference

Customize the categories, channel names, and sorting to your pleasure. Rename, reorder, and organize your content exactly how you want it.

Share your playlist

Generated secure M3U8 URLs work in VLC, Kodi, or TiviMate. Your linked playlist is compatible with any player supporting M3U and Xtream formats.

lightbulb
Pro tip
By swiping left on the list entries, you can rename categories and channels in your Linked Playlist to make them uniquely yours. The changes only affect your linked list, 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 Linked Playlist. 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.

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.

How to: @username sharing

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

Real-time notifications

When someone shares a Linked Playlist with you, you'll receive an instant push notification. Tap the notification to automatically add the shared playlist to your collection. No manual configuration needed!

How to: Universal M3U links

1. Create a shareable link in the app. 2. Copy the secure M3U URL or XTREAM Codes credentials. 3. Paste it into VLC, Kodi, TiviMate, or any player supporting M3U and XTREAM formats. 4. Works instantly with no GridStreamr account required for the recipient.

Universal Reach - External Players

Your curated Linked Playlists work with any external media player that supports XTREAM Codes API or M3U playlist formats. Share with friends who use VLC, Kodi, TiviMate, or any other compatible player. Your playlists are accessible everywhere!

Secure by design

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

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 & Guide

Browse categories or use the full-screen player. Free: Current/Next info. Premium: Full timeline view of the day's programming.

Movies & Series

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

Favorites

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

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.
FAQ

Frequently Asked Questions

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 linked playlist 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.

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.

What is the difference between free and premium?

Free tier is perfect for getting started, allowing 1 Xtream account, 1 regular playlist, and 1 linked playlist with current/next EPG info. Premium unlocks unlimited sources, full day EPG timelines, M3U file exports, and professional playback controls like subtitle and audio track selection.

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.

Can I use GridStreamr on my TV?

Yes! Currently, you can share your curated Linked Playlists from your phone directly to your Smart TV's existing IPTV player using our secure M3U export or XTREAM compatibility features. We are also hard at work on dedicated Android TV and tvOS apps, which are coming very soon for a fully native big-screen experience.