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.

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.

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
40,000+ Channels

GridStreamr Global EPG

Exclusively for Linked Playlists or reconfiguring existing XTREAM lists, access the new Global EPG source featuring 40,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 Linked Playlists.

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

add_circle
01

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.

playlist_add
02

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.

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 playlist

Generated secure GridStreamr XTREAM URLs work in VLC, Kodi, or TiviMate. Your linked playlist 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.

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.

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 Linked Playlist → 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 Linked Playlist with you, you'll receive an instant push notification. Tap the notification to automatically add the shared playlist to your collection. You can also configure personalized EPG notifications for your favorite programs!

public
04

Universal Reach - External Players

Your curated Linked Playlists work with any external media player that supports XTREAM Codes. Share with friends who use VLC, Kodi, TiviMate, or any other compatible player. Your playlists 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.

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.
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 40,000+ channel Global EPG catalog to guarantee accuracy.
HowTo

HowTo Videos.

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

Linked Playlist Creation and Edit

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

Watch on dedicated pagearrow_forward

Configure Linked Playlist 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 on dedicated pagearrow_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 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.

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 Linked Playlist?

In your Linked Playlist 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

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, Custom EPG Configuration, and professional playback controls like subtitle and audio track selection.

05

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.

06

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.