UltimateIPTV Player

A modern, high-performance Windows desktop application for loading M3U/M3U8 playlists and streaming live TV channels. Built with Electron, Vanilla JS, and HLS.js.

(Note: Add your application screenshot here!)

---

🚀 Features

• 📺 Live IPTV Streaming: Native HTTP/HTTPS live streaming support with HLS.js integration.
• 📁 Playlist Management:
  • Load local .m3u or .m3u8 playlists.
  • Import playlists directly via URL (supports automatic redirects).
  • Drag-and-drop playlist importing.
• ⚡ High Performance Virtual Scrolling: Effortlessly handles large playlists (10,000+ channels) with a custom virtual list renderer, keeping memory usage low and rendering at a smooth 60fps.
• 📅 Electronic Program Guide (EPG): Load XMLTV format EPGs to view live schedules, program details, and progress.
• 📌 Multi-View / Pinned Players: Pin multiple channels to watch them simultaneously.
• 🔍 Smart Channel Browsing:
  • Search/filter channels instantly by name.
  • Categorized grouping based on M3U tags (group-title).
  • Favorites/pinned lists for quick access.
• 🎨 Sleek Custom UI:
  • Frameless modern window design with responsive sidebar and title bars.
  • Custom media controls (play/pause, volume control, mute, fullscreen toggle, quick channel switching).
  • Premium dark theme interface matching modern aesthetic standards.

---

🛠️ Tech Stack

• Framework: Electron 27+
• Frontend: HTML5, CSS3 (Vanilla), Vanilla JavaScript
• Video Playback Engine: HLS.js (HTTP Live Streaming)
• Logging: Electron-log
• Packaging: Electron Builder

---

📂 Project Structure

UltimateIPTV/
├── assets/              # Application assets (icons, images)
├── src/                 # Frontend source files
│   ├── index.html       # Main window layout
│   ├── styles/
│   │   └── main.css     # UI styles & theme
│   └── scripts/
│       ├── app.js       # Main application lifecycle & UI controller
│       ├── parser.js    # M3U/M3U8 file parser
│       ├── store.js     # Channel store & state manager (favorites, history)
│       ├── player.js    # HLS.js video player wrapper
│       ├── epg.js       # Electronic Program Guide (XMLTV) handler
│       ├── virtualScroller.js # High performance list view renderer
│       └── pinnedPlayers.js   # Multi-view layout system
├── main.js              # Electron main process
├── preload.js           # Electron IPC bridge
├── package.json         # Scripts, configurations, and dependencies
└── README.md            # Project documentation

---

⚙️ Getting Started

Prerequisites

You need Node.js installed on your machine.

Installation

1. Clone the repository:

   git clone https://github.com/adem-rguez/UltimateIPTV.git
   cd UltimateIPTV

2. Install dependencies:

   npm install

Running the Application

To start the application in development mode:

npm start

Packaging / Building for Windows

To package the application into a standalone installer (.exe):

npm run build

To build a unpackaged directory version for testing:

npm run build:dir

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.