Settings

Playlists, preferences, cache, and the app itself.

Playlists

No playlists yet.
Add playlist

New custom playlist

Appearance

Display

Language

Pick a language for the interface. Translations are community-driven - missing strings fall back to English.

Theme
Accent color
Font scale

Bumps the base font size. Use Large or X-Large when viewing on a TV from across the room.

Density

Tightens or loosens spacing in lists and menus. Independent of font scale.

Performance mode

Disables decorative animations (the comet in the sidebar, hub entry stagger, sliding focus ring) for smoother scrolling and D-pad navigation on TV boxes and low-end devices.

Behavior

Interface sounds

A soft chime when the app starts and gentle ticks when moving around with a remote or keyboard. Mouse and touch stay silent.

TV safe area

Most TVs hide a small band at each edge of the picture (overscan). If sidebar icons or version text look cut off, increase this to inset the whole UI by a few percent.

Home page sections

Choose which sections appear on your home page and what order they're in.

On the home page

  • Favorites
  • Continue watching
  • Watchlist
  • Recently added
  • Because you watched

Available sections

Watching

Live TV

Show EPG by default
Channel column width

EPG time zone

Some providers ship XMLTV with timestamps already shifted to the server's local time, so EPG times look off. Auto-detect picks the offset where the most channels have a programme airing right now.

Continue watching

How long to keep paused movies and episodes in Continue Watching. Older entries are dropped on the next save. The 200-item cap still applies regardless.

Playback

Choose how streams open. External players play 4K and HDR more reliably.

Playback

Group language variants

Combine copies of the same title in different languages into one entry. Turn off if titles are grouped incorrectly for your provider.

Preferred audio language

When a title exists in several languages, open and recommend this one first. Auto follows the interface language.

Mono audio

Play all audio in both ears as a single channel - useful with one earbud. Applies to streams played by the built-in engines; some directly played files keep their original stereo.

Captions on by default

Automatically turns on subtitles when a movie or episode has them, preferring your app language. You can still turn them off in the player. Applies to this device.

Network

Network

Relay host: https://relay.guruiptv247.com

User-Agent preset

Some IPTV providers reject the default browser User-Agent. Pick a preset or enter a custom string. Applies to provider API, M3U, and EPG fetches. Effective in the desktop build.

Custom (overrides preset)

Request timeout

How long to wait for a provider response before giving up. Bump this when a large catalog (tens of thousands of movies / series) times out before it finishes loading.

Developer mode

Unlocks a network log of recent provider requests, useful when troubleshooting a connection issue. Off by default.

Metadata enrichment

TheTVDB works out of the box for posters, cast, and episode details. Add a TMDb key to also unlock trailers and similar titles.

TheTVDB metadata

Titles you open are sent to TheTVDB through our proxy to look up artwork and episode details. No account or key is needed.

Enable enrichment

Optional: adds trailers, cast, and similar titles once you add a TMDB key below. Titles you open are sent to TMDB for matching.

API key

Paste a free TMDB API key or v4 access token.Get a key at themoviedb.org

This product uses the TMDB API but is not endorsed or certified by TMDB.

Library

Categories

Per-playlist mute list. Hidden categories are hidden from the picker and the main grid on Live TV, Movies, and Series.
Nothing hidden
No hidden categories for this playlist.

Channel edits

Custom names, logos and numbers you set from a channel's right-click menu on Live TV, plus the channels you hid. Provider data is never changed, so any edit can be reset.

Select a playlist first.

Favorites

Reorder your favorites per kind. The hub Favorites strip and the per-page favorites filter follow this order.
No favorites yet
Star a channel, movie, or series to add it here.

Data

Downloads

Save to

Folder where new downloads land. Manage the queue itself on theDownloads page.

Restore from folder

After a reinstall, scan the folder above for `.xtmeta.json` sidecars and re-add the matching files to your downloads list.

Concurrent downloads

Most Xtream providers cap connections per account, so a second parallel download fails mid-stream. Keep this at 1 unless your provider explicitly allows multiple slots.

Backup

Save all playlists, favorites, recents, watched progress, hidden categories, and app settings to a file. Cache and the downloads queue are not exported.

Storage

Cache

-Last updated-

Clear cache

Clears channel, movie, and series lists. Playlists, favorites, and recents are kept.

Clear viewing history

Removes continue watching and recently watched items from every playlist. Favorites and watchlist are kept.

About

Current
-
Latest
-
Account expires
-

Automatic updates

When disabled, updates will not install automatically. You will still see when one is available.

Update channel

Beta versions are early test builds and may be unstable.

GitHub

What's new

Loading…

Licenses and attribution

FFmpegLGPL 2.1+

The Windows and Linux desktop builds bundle a trimmed FFmpeg build (LGPL v2.1 or later), used only to convert live TV audio the app can't otherwise play.

TMDB

This product uses the TMDB API but is not endorsed or certified by TMDB.themoviedb.org

hls.js · mpegts.js · Shaka Player · Video.js · ArtPlayerAPACHE-2.0 · MIT

mpegts.js ships with a small audio-track fallback patch.View patch

Geist Variable · Instrument SerifSIL OFL

Self-hosted typefaces.

Tauri · Tabler IconsMIT / APACHE-2.0

App framework and icon set.

TheTVDBMetadata

Metadata provided by TheTVDB. Please consider adding missing information or subscribing.

TMDBMetadata

This application uses TMDBand the TMDB APIs but is not endorsed, certified, or otherwise approved by TMDB.

Help & feedback

Read the docs

Step-by-step guides for sign-in, external players, the keyboard and D-pad bindings, and the most common things people get stuck on.

Found a bug or have a suggestion?

Bug reports, feature requests, questions, and general feedback all go to GitHub - search existing issues first, or pick a template and open a new one.

Save a single file with app and device details, recent network activity, playlist types and the newest log files. Attach it to a bug report so the problem can be traced.

Usernames, passwords and tokens are stripped out. Server names can still appear, so review the file before posting it publicly.

Discord community

Questions, feedback, and beta chat - come say hi.

Like the app?

Guru IPTV App is free and open source. If it saves you time or sweetens your living-room setup, a small tip helps cover hosting, signing certs, and the next round of features.

No tracking, no ads, no telemetry - just a thank-you button.

Danger zone

Reset everything

Wipes all app data: playlists, cached lists, favorites, recents, and locally stored EPG references. Next launch starts from a clean slate.

Reset everything?

This wipes all playlists, favorites, recents, and cached lists. This can't be undone.

Replace everything with this backup?

Import will replace all playlists, favorites, recents, watched progress, hidden categories, and app settings on this device.