# technomancer702/nodecast-tv

A self-hosted web application that lets you stream Live TV, Movies, and Series from your Xtream Codes or M3U provider directly in your browser. It's built with performance in mind and handles large libraries smoothly.

Repository: https://github.com/technomancer702/nodecast-tv
Canonical: https://ross.abutalabs.com/products/nodecast-tv
Language: JavaScript
License: GPL-3.0
License Family: copyleft
Last push: 2026-03-02T23:10:21+00:00

## Health v2 (maintenance only)
Score: 58/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 70, release rhythm 66, longevity 17
- inputs: {"age_days": 249, "days_push": 184, "days_rel": 226, "gap_med": 0, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1480, forks 226 (observed 2026-08-28T04:04:50.641998+00:00)

## What it is
nodecast-tv is a self-hosted web-based IPTV player that streams Live TV, Movies, and Series from Xtream Codes or M3U providers directly in the browser. It includes an EPG guide, favorites, user authentication with OIDC SSO, and GPU-accelerated transcoding, optimized for very large playlists.

## Use cases
- stream my IPTV provider's live channels in a browser
- self-host a web player for my Xtream Codes subscription
- watch M3U playlist movies and series with metadata and posters
- view an interactive EPG TV guide for my channels
- transcode streams with GPU acceleration for smooth playback
- share IPTV access with family using user accounts and SSO
- handle a playlist with thousands of channels without lag

## When to choose
- you want a browser-based self-hosted IPTV frontend for Xtream Codes or M3U sources
- you need EPG, VOD, and series support in one app
- you have a very large playlist and need virtual scrolling performance
- you want hardware-accelerated transcoding and Docker deployment

## When to avoid
- you need a native TV or mobile app rather than a web interface
- you want a full media server that manages your own local files like Jellyfin or Plex
- you don't have an IPTV provider or M3U playlist to consume
- you need DVR/recording functionality

## Facets
- artifact type: application
- maturity: active
- function: http-server, streaming, auth, video-processing, web-framework
- domain: media, self-hosted, web-development
- platform: self-hosted, cross-platform
- tags: iptv, xtream-codes, m3u, epg, vod, live-tv, transcoding, media-server, oidc-sso, video, nodejs, web-server, docker

## Member repositories
- technomancer702/nodecast-tv (main) score 58

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:50.641998+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:34:16.265021+00:00, confidence not recorded.
  - readme: https://github.com/technomancer702/nodecast-tv (fetched 2026-08-28T04:04:50.641998+00:00, sha 7795dba3fe69)
- Data as of 2026-08-30T08:39:29.467469+00:00.