Skip to content
Lumio TV icon

Lumio TV

An IPTV player that behaves well on phones, tablets, and Android TV.

Entertainment2024iOS · Android · Web · Android TV

The product

A multi-provider IPTV client with M3U and Xtream support, live EPG, channel management, and resilient playback across mobile, web, and Android TV.

IPTV is a hostile environment: providers change formats, streams stall, and users expect television-grade reliability. I built Lumio TV around a tolerant parser, explicit playback states, and a remote-first TV interface, then reused the same core for mobile and web. The interesting engineering was not the player — it was making failure legible so users know whether the network, the provider, or the stream is the problem.

What is inside

  • M3U playlists and Xtream Codes providers
  • Live EPG guide with channel metadata
  • Favorites, recents, and channel search
  • Android TV focus navigation and remote support
  • Resilient stream recovery and error states
  • Shared Flutter core across iOS, Android, and web

Engineering decisions

  1. 01

    A tolerant parser for M3U and Xtream differences

    Providers publish inconsistent playlists and API responses. Parsing was isolated from playback and permissive where the format allows, so one provider quirk does not break the whole catalogue.

    Trade-off More fixtures and edge cases to maintain, and some invalid input is accepted by design.

  2. 02

    Explicit playback states instead of silent retries

    Users need to know whether the network, provider or stream failed. Buffering, retrying, ended and error states are distinct and visible rather than collapsed into a spinner.

    Trade-off More UI states to design and test on every platform.

  3. 03

    One shared Flutter core with a TV-first interaction layer

    Mobile, web and Android TV reuse the same catalogue and playback core, while focus navigation and remote input stay platform-specific.

    Trade-off Each platform still needs its own interaction testing; sharing code does not share the remote control.

Stack

FlutterM3UXtream CodesEPGAndroid TV
Lumio TV screenshot 1
Lumio TV screenshot 2
4Platforms
M3U + XtreamProvider formats
TV-firstInteraction model

Work with Hasan

Available for senior Flutter and AI engineering work, including app rescues, architecture reviews, and 0-to-1 product builds.

Talk about a project