All projects

Independent project · Media & native apps

Simple IPTV Player

A focused, native player for Apple TV.

A channel list that belongs on a TV.

Simple IPTV Player brings personal M3U playlists to Apple TV through a native SwiftUI interface designed for the remote.

VLC handles a broad range of streaming protocols and media formats. The app includes subtitle and audio-track selection, while Home Assistant can start playback through media_player.play_media. There is no required cloud account, advertising, or tracking.

The app plays content from your own M3U playlists; it does not include channels or streaming content. Deep links such as iptvplayer://play?channel=XXXX_NAME open a channel directly.

Design for the remote

A native tvOS interface focuses on channel navigation and playback from the sofa.

Support existing playlists

Standard M3U playlists and VLC playback cover HLS, MPEG-TS, RTSP, and other supported formats.

Fit into home automation

Home Assistant can request direct playback using a media URL.

Architecture & decisions

Use a native remote-first interface with VLC for broad format support. Accept standard M3U playlists and expose playback to Home Assistant.

Key components & responsibilities
  1. M3U playlist
  2. SwiftUI · remote navigation
  3. VLC · stream playback
  4. Apple TV

A high-level view of the project’s components and workflow.

Implementation details

SwiftUI / tvOS / VLC

  • Native SwiftUI application built specifically for Apple TV (tvOS)
  • Fast startup and instant channel loading with smooth IPTV playback
  • No ads, no tracking, and no cloud dependency, fully privacy-first
  • Wide streaming format support powered by the built-in VLC engine
  • Supports HLS (.m3u8), MPEG-TS, RTSP/RTP, HTTP & HTTPS streams
  • Supports UDP multicast & unicast, MPEG-DASH, Icecast, and Shoutcast
  • Plays common media formats: MP4, MKV, AVI, FLV, WebM, and more
  • Home Assistant integration for direct channel playback
  • Supports media_player.play_media with URL content type
  • Subtitle and audio track selection directly from the player UI
  • Universal M3U playlist support with no vendor lock-in
  • Direct channel playback through iptvplayer:// deep links

Outcomes

Native Apple TV playback without advertising, tracking, or a required cloud account.

Explore the project

See the product, documentation, or available downloads.

Have something in mind?

Let's make it work.

[email protected]