pyiptv 1.0.0

A modern IPTV player built with PySide6

PyIPTV

A Modern Python IPTV Player

Feature-rich IPTV player built with PySide6/Qt6 for streaming live television content from M3U playlists

---

✨ Features

Core Functionality

• 📺 M3U Playlist Support - Load and manage IPTV playlists in M3U format
• 🎨 Modern Qt6 Interface - Built with PySide6 for a responsive, native desktop experience
• 📂 Category Organization - Automatically organize channels by categories
• 🔍 Search & Filtering - Quickly find channels with real-time search
• 🎵 Audio Track Selection - Multi-language audio track support

User Experience

• 🌓 Theme Support - System-aware theming with KDE integration
• ⚡ Performance Optimized - Handles large playlists with virtualized lists and smart buffering
• ⚙️ Settings Management - Persistent settings with user-friendly configuration
• 🖥️ High DPI Support - Optimized for high-resolution displays

🚀 Installation

From PyPI (Recommended)

pip install pyiptv

Using uvx (Isolated execution)

uvx pyiptv

From Source

git clone https://github.com/dmarkey/PyIPTV.git
cd PyIPTV
pip install -e .

📖 Usage

Basic Usage

Launch PyIPTV without arguments to open the playlist manager:

pyiptv

Direct Playlist Loading

Launch directly with a playlist file:

pyiptv /path/to/your/playlist.m3u

Command Line Arguments

Command	Description
pyiptv	Launch with playlist manager
pyiptv <playlist_path>	Launch directly with specified playlist

📋 Requirements

Component	Version	Description
Python	3.8+	Core runtime
PySide6	6.5.0+	Qt6 bindings
Qt6 multimedia libraries	Latest	Media playback
Operating System	Linux, Windows, macOS	Cross-platform support

System Dependencies

🐧 Linux (Ubuntu/Debian)

sudo apt install python3-pip qt6-multimedia-dev

🎩 Linux (Fedora/CentOS)

sudo dnf install python3-pip qt6-qtmultimedia-devel

🍎 macOS

brew install python qt6

🪟 Windows

No additional system dependencies required - PySide6 includes all necessary Qt libraries.

⚙️ Configuration

PyIPTV automatically creates configuration files in platform-appropriate locations:

Platform	Configuration Path
Linux	~/.config/PyIPTV/pyiptv_settings.json
Windows	%APPDATA%/PyIPTV/pyiptv_settings.json
macOS	~/.config/PyIPTV/pyiptv_settings.json

Available Settings

• Theme Mode - System auto-detection, light, or dark themes
• Buffering - Adjustable buffering time for smooth playback
• Performance - Options for handling large playlists
• UI Preferences - Window geometry, splitter sizes, and more

📝 Playlist Format

PyIPTV supports standard M3U playlist format with extended information:

#EXTM3U
#EXTINF:-1 tvg-id="channel1" tvg-name="Channel Name" tvg-logo="logo.png" group-title="Category",Channel Display Name
http://example.com/stream1.m3u8
#EXTINF:-1 tvg-id="channel2" tvg-name="Another Channel" group-title="Movies",Movie Channel
http://example.com/stream2.m3u8

🏗️ Architecture

PyIPTV follows a modular architecture design:

┌─────────────────┐
│ Main Application│
├─────────────────┤
│ UI Components   │
│ Playlist Manager│
│ Media Player    │
│ Settings Manager│
│ Theme Manager   │
└─────────────────┘

Components

• Main Application - Entry point and application lifecycle management
• UI Components - Modular Qt widgets for different functionality
• Playlist Manager - M3U parsing and playlist management
• Media Player - Qt6 multimedia integration
• Settings Manager - Configuration persistence
• Theme Manager - System-aware theming

🛠️ Development

Setting up Development Environment

git clone https://github.com/dmarkey/PyIPTV.git
cd PyIPTV
pip install -e ".[dev]"

Running Tests

pytest

Code Formatting

black pyiptv/
isort pyiptv/

Linting

flake8 pyiptv/

🔧 Troubleshooting

Common Issues

Issue	Solution
Video playback problems	Ensure Qt6 multimedia libraries are installed
Theme not applying correctly	Check desktop environment compatibility
Performance issues with large playlists	Adjust performance settings in configuration

Debug Mode

Run with debug information:

PYTHONPATH=. python -m pyiptv.main --debug

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Guidelines

• Follow PEP 8 style guidelines
• Add tests for new features
• Update documentation as needed
• Ensure compatibility with supported Python versions

📄 License

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

🙏 Acknowledgments

• Most of the codebase for PyIPTV was generated by Claude Sonnet 4
• Built with PySide6 - Qt for Python
• Inspired by the need for a modern, cross-platform IPTV player
• Thanks to the open-source community for tools and libraries

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: [e-mail]

---

⚠️ Legal Notice

This software is for personal use with legally obtained IPTV content. Users are responsible for ensuring they have appropriate rights to access any content streams.