whatisgithub

What is owntv?

ahxn00/owntv — explained in plain English

Analysis updated 2026-05-18

39KotlinAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

An open-source, remote-controlled IPTV player for Android TV that plays your own M3U or Xtream playlists with a full EPG guide and offline downloads.

Mindmap

mindmap
  root((OwnTV))
    What it does
      Plays M3U or Xtream sources
      Remote-first TV interface
      EPG program guide
    Tech stack
      Kotlin
      Jetpack Compose for TV
      libmpv FFmpeg
    Use cases
      Watch your own IPTV playlist
      Browse Live TV Movies Series
      Download for offline viewing
    Audience
      Android TV users
      Cord cutters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch a personal M3U or Xtream IPTV playlist on Android TV with a remote-friendly interface.

USE CASE 2

Browse Live TV, Movies, and Series through a full EPG time-by-channel guide.

USE CASE 3

Download movies or episodes for offline viewing with pause and resume support.

What is it built with?

KotlinJetpack ComposelibmpvFFmpegRoom

How does it compare?

ahxn00/owntvomarahmedx14/my-android-playgroundwifi-x-smasher/nuvio-windows-unofficial
Stars393025
LanguageKotlinKotlinKotlin
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

You must supply your own legally accessible M3U or Xtream playlist source, the app provides no content itself.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

OwnTV is an open-source IPTV player for Android TV devices, built with Kotlin and designed to be controlled entirely with a TV remote. It does not provide any channels or streaming content: you bring your own playlist by adding an M3U file or connecting an Xtream-compatible source. The app then gives you a browsable, remote-friendly interface for watching that content. Playback is handled by libmpv, a media player library that can play nearly any video format. On capable TV hardware, it renders video through a direct path to the display, which keeps 4K and HDR streams smooth and avoids extra processing steps. Subtitles and audio tracks are fully exposed, and users can switch between them, adjust playback speed, and control aspect ratio from a heads-up display that appears over the video. The interface divides content into categories: Live TV, Movies, Series, Downloads, and an EPG program guide. The EPG shows a time-by-channel grid for browsing what is on and what is coming up, and you can tune to a channel directly from the guide. The app supports multiple user profiles, each with its own watch history, favorites, and resume positions, and profiles can be protected with a PIN. Categories can be hidden, renamed, and reordered per profile. Downloaded movies and episodes can be saved for offline viewing, with pause and resume support. Playback positions are remembered across sessions for both movies and series. A backup and restore feature lets you export all settings, sources, favorites, and watch history to a single file. The app is open source under the MIT license and was built with assistance from AI tools.

Copy-paste prompts

Prompt 1
Set up OwnTV on my Android TV and add an M3U playlist source
Prompt 2
Explain how to configure an Xtream source and custom EPG URL in OwnTV
Prompt 3
How do multiple profiles with PIN locks work in OwnTV?
Prompt 4
Walk me through OwnTV's backup and restore feature

Frequently asked questions

What is owntv?

An open-source, remote-controlled IPTV player for Android TV that plays your own M3U or Xtream playlists with a full EPG guide and offline downloads.

What language is owntv written in?

Mainly Kotlin. The stack also includes Kotlin, Jetpack Compose, libmpv.

What license does owntv use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is owntv to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is owntv for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.