• 🎬 Advanced Video Engine: Seamless playback for HLS, DASH (with ClearKey DRM), and MPEG-TS streams using native and custom engines (hls.js, shaka-player, mpegts.js).
• 🎛️ Cinematic Player Experience: Custom video quality selection with precise Mbps analytics, Picture-in-Picture (PiP), double-tap seek, and automatic 10-second error recovery channel switching.
• 🛡️ Security & Proxy Routing: Built-in secure proxy to bypass CORS and Geo-blocking with custom headers, protected by Anti-SSRF DNS validation and Cloudflare Turnstile Server Actions.
• ⚡ High-Performance Architecture: Instant loading via SHA-256 IndexedDB channel caching, smart proxy bypass for direct streams, and live real-time watcher telemetry.
• ☁️ Cloud Playlist Sync: Built-in Google OAuth authentication with a PostgreSQL database to securely save and sync custom M3U/JSON playlists across all your devices.
• ✨ Premium Glassmorphic UI: Responsive interactive channel grid, seamless skeleton loaders, sticky headers, knockout bracket cards, and a GPU-optimized 3D CSS cyber background.
• 📂 BDIX FTP Portal: An elegant directory for local BDIX media servers featuring real-time online status and speed diagnostics.

• Framework: Next.js 16 (App Router)
• Library: React 19
• Styling: Tailwind CSS v4
• Animations: Motion
• Authentication: NextAuth.js (Auth.js) (Google Provider)
• Database ORM: Prisma (PostgreSQL)
• Stream Engines: HLS.js, Shaka Player (for DASH & ClearKey DRM), & mpegts.js (for legacy MPEG-TS)
• HTTP Client: Undici (for secure proxy streaming)

Ensure you have Node.js (v22.19.0 or newer) installed.

1. Clone this repository:

   git clone --depth=1 https://github.com/SHAJON-404/iptv.git
   cd iptv

2. Configure environment variables: Create a .env file in the root directory:

   # Site Configuration
   NEXT_PUBLIC_SITE_URL=http://localhost:3000
   
   # Popup Configuration
   SHOW_POPUP=True
   
   # Cloudflare Turnstile Verification Configuration
   NEXT_PUBLIC_TURNSTILE_SITE_KEY=your-site-key
   TURNSTILE_SECRET_KEY=your-secret-key
   NEXT_PUBLIC_DISABLE_TURNSTILE=False
   
   # Developer/Local Subnet Origins (CORS validation bypass)
   ALLOWED_DEV_ORIGINS=live.shajon.dev,192.168.0.57
   
   # Database & Authentication (For Cloud Sync)
   DATABASE_URL="postgresql://user:password@host:port/dbname?schema=public"
   NEXTAUTH_URL=http://localhost:3000
   NEXTAUTH_SECRET=your-random-secret
   GOOGLE_CLIENT_ID=your-google-client-id
   GOOGLE_CLIENT_SECRET=your-google-client-secret

3. Setup the database and install dependencies:

   npm install
   npx prisma db push
   npx prisma generate

4. Run the development server:

   npm run dev

5. Open http://localhost:3000 in your browser.

To build and run the application in production mode:

npm run build
npm start

You can deploy the application using the preconfigured multi-stage Dockerfile (optimized for Node.js 22):

docker build -t iptv-player .
docker run -p 3000:3000 iptv-player

This repository does not host, store, retransmit, or own any television channels or media content. The web player only processes and plays data from the user's own provided playlist files (M3U or JSON) or publicly available stream links. Channel availability may change, expire, or stop working at any time.

If you are the copyright owner of any content and would like it removed, please refer to our Security & DMCA Policy or contact the developer directly.

Special thanks to all IPTV open-source repository maintainers and contributors whose publicly available playlists and stream sources make this collection and player possible.

This project is open-source software licensed under the GNU General Public License v3 (GPLv3).

1. Copyleft Protection & Mandatory Open Source: You are free to use, modify, and build upon everything in this repository, but any derivative player, application, or database MUST remain fully open-source and distributed under the same GPLv3 license.
2. Preserve Developer Attribution: You must preserve all S. SHAJON copyright, developer profile links (GitHub, Telegram, Facebook), and licensing labels in both the user interface and code files.
3. No Commercial Ads or Betting/Gambling Promotions: If you build your own IPTV player or service based on this codebase, database, or resources, you are strictly prohibited from integrating or displaying any form of commercial advertisements, pop-up ads, redirect ads, or betting/gambling promotions of any kind.