README

Your own IPTV player for Android TV
  Fast · modern · remote-first — bring your own M3U, Xtream or Stalker (MAC) sources



  
  
  
  
  
  
  
    
  



  
    
  


---
OwnTV is a native Android TV IPTV player, built with Kotlin and Jetpack Compose for TV. It
runs two playback engines — libmpv (FFmpeg) for the widest compatibility, ExoPlayer (Media3) for
near-instant Live TV — and it is a player only: you bring your own Xtream login, M3U
playlist (URL or a local file) or Stalker/Ministra portal.

 ⚠️ OwnTV ships no channels, playlists, subscriptions or streams. You are responsible for the
 sources you add.

Open source, GPLv3, original code, built with the help of AI. Android TV only — leanback
launcher, D-pad first.

  📖 New here? User Guide →
 Every feature, where to find it, and the remote shortcuts — on one page.

---

 💬 Community

Questions, ideas, bug reports — join the OwnTV Telegram group:

 👉 t.me/owntvplayer



---

 ✨ Features

 🎬 Playback
- Two engines — mpv for compatibility, ExoPlayer for instant Live TV, with automatic fallback and a per-channel override
- 4K HDR direct rendering, optional auto frame-rate matching, surround sound with a stereo safety net, 150% volume boost
- Subtitles — text, image and closed captions, plus OpenSubtitles search and local files
- Resume, next-episode auto-play, mini-player/PiP, picture-in-picture when you press Home, audio-only mode, live stream-info overlay
- Media-session transport keys and proper audio focus — it behaves like a TV app
- An error log you can export for any stream that misbehaves

 🧭 Browse
- Home with Continue Watching and Now Trending (TMDB rankings matched to what your provider can actually play)
- Live TV · Movies · Series · Downloads · Guide, with per-profile row order, Favorites, History and search
  (voice search where the TV has a speech recogniser)
- Multiple playlists at once, with provider labels everywhere they could be confused
- Rename, hide, reorder and combine categories; bulk rename rules
- TMDB posters, plots, cast and trailers in 40 languages — scales to ~50k channels / ~168k movies
- Two layouts for Movies & Series — the classic three panels, or Cinematic: the focused title's artwork full-bleed behind the whole screen, with its details and cast above a wide poster grid
- Adjustable panel widths per section, including hiding the preview pane entirely

 📥 Sources & EPG
- Xtream, M3U and Stalker/Ministra — add any of them from your phone over Wi-Fi (QR + PIN)
- TV Guide (XMLTV) with a live Now marker, multiple guide sources and automatic channel matching
- Catch-up TV up to 7 days, live rewind, and Go back to… even for channels with no guide
- Guide time offset, per-source guide logos, per-channel EPG fixes
- Protected (DRM) channels — Widevine and ClearKey, read from the playlist, nothing to configure
- Custom DNS (Google, Cloudflare, Quad9, DoH or your own)

 ⏺️ Recording & Multiview
- Record live TV from the guide, the channel list or while watching — inclu

Top issues

Discussions

Latest release

✨ New features
- ⚡ Search: the poster backdrop is blurred once, and blurred on Android 11 and older too (community PR 268 by @sarmadsoomro)
- 🖼️ More posters kept in memory, so Home scrolls cleaner (community PR 267 by @sarmadsoomro)
- 📺 Smoother TV Guide scrolling (community PR 266 by @sarmadsoomro)
- ✨ Clean channel names: a Names option on each playlist (community PR 283 by @Kevsosmooth)
- 📋 EPG Sources: Move up / Move down set the guide priority (community PR 277 by @Kevsosmooth)
- 🎯 Guide offers Auto-match when an added guide matches no channel (community PR 316 by @arch-fan)
- ⏪ Rewind m