https://github.com/imp0str/lunaiptv

A modern, user-friendly IPTV player built with **Python** & **PyQt6** — lightweight, customizable, and designed to make streaming effortless.
https://github.com/imp0str/lunaiptv

gui iptv m3u pyqt6 python streaming tv video-player vlc windows xstream

Last synced: about 2 months ago
JSON representation

A modern, user-friendly IPTV player built with **Python** & **PyQt6** — lightweight, customizable, and designed to make streaming effortless.

• Host: GitHub
• URL: https://github.com/imp0str/lunaiptv
• Owner: imp0str
• Created: 2025-08-10T17:38:39.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-08-10T19:15:23.000Z (10 months ago)
• Last Synced: 2025-08-10T20:23:47.494Z (10 months ago)
• Topics: gui, iptv, m3u, pyqt6, python, streaming, tv, video-player, vlc, windows, xstream
• Homepage:
• Size: 37 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🌙 LunaIPTV

### 🌙 Logo

![LunaIPTV Logo](./assets/LunaIPTV.png)

[![Python](https://img.shields.io/badge/Python-3.11.9+-blue.svg)](https://www.python.org/)

[![PyQt6](https://img.shields.io/badge/GUI-PyQt6-green)](https://pypi.org/project/PyQt6/)

[![VLC](https://img.shields.io/badge/Playback-VLC-orange)](https://www.videolan.org/vlc/)

[![License](https://img.shields.io/badge/License-MIT-lightgrey)](LICENSE)

[![Made With Love](https://img.shields.io/badge/Made%20With-%E2%9D%A4-red)](#)

A modern, user-friendly IPTV player built with **Python** & **PyQt6** — lightweight, customizable, and designed to make streaming effortless.

---

## 📖 Description

LunaIPTV is a sleek IPTV client built for smooth, reliable streaming.  

It integrates **Xstream API login**, **VLC playback**, and a clean **PyQt6 interface** to give you a no-fuss IPTV experience.  

Whether it’s live TV, sports, or on-demand series, LunaIPTV keeps it simple without sacrificing power.

---

## ✨ Features

### 🎯 Core

- **Xstream API Login** – quick, secure authentication with your IPTV provider.

- **Channel & EPG Browsing** – see what's on now and what's coming up.

- **VLC Integration** – full codec support for smooth, lag-free playback.

- **Search & Filter** – quickly find your favorite channels.

### 🖥 User Interface

- **Clean, Modern PyQt6 Design** – responsive layout for desktops.

- **Category Tabs** – Live TV, Movies, Series — switch in a click.

- **Toolbar Controls** – Settings, About, Refresh at your fingertips.

- **Custom App Icon** – LunaIPTV branding in the window and taskbar.

### 📺 Playback

- **Supports HD, Full HD, and 4K** – based on your provider’s stream quality.

- **Buffer Management** – smoother playback, fewer interruptions.

- **Full-Screen Mode** – immersive viewing without distractions.

### ⚙ Extras

- **Automatic VLC Path Detection** – guides first-time setup.

- **Minimal Error Popups** – avoids random timeout spam.

- **Portable Build Option** – distribute as a single EXE (PyInstaller).

---

## 📸 Screenshots

| Live TV View | Movies / Live Search | Series Continue |

|--------------|----------------------|-----------------|

| ![Live TV View](./assets/LiveTVView.png) | ![Movies and Live Search](./assets/Movies-LiveSearchView.png) | ![Series Continue](./assets/SeriesContinueView.png) |

---

### 🎬 Watch View

![Watch View](./assets/WatchView.png)

## 🚀 Installation

### From Source

```bash

# Clone repository

git clone https://github.com/YOUR-USERNAME/LunaIPTV.git

cd LunaIPTV

# Run

run LunaIPTV.exe