The Ultimate Minimalist, High-Performance IPTV Web Player
Live Demo • Report Bug • Request Feature • Contribute
Welcome to StreamOS, a blazing-fast, strictly client-side React + Vite web application built for aggregating, filtering, and streaming .m3u and .m3u8 IPTV playlists. Featuring a gorgeous glassmorphic UI, dynamic category/language/country filtering, intelligent mobile PWA support, and secure local cookie persistence—all without requiring a backend database!
| Feature | Description |
|---|---|
| 🚀 Serverless Architecture | Entirely client-side. No databases to maintain or backend servers to pay for. |
| 📱 PWA & Mobile Native Feel | Fully optimized Progressive Web App. Install directly to your iOS/Android home screen. Includes Haptic Touch, Double-Tap to Seek, Swipe Volume, and Screen Lock modes. |
| 🎨 Glassmorphic Interface | Breathtaking, premium dark-mode UI meticulously crafted with TailwindCSS, featuring smooth GSAP micro-animations and Cinematic Background Ambilight. |
| 🌍 Dynamic Full-Scale Filtering | Stacked filters that auto-update dynamically based on standard .m3u tags (tvg-country, tvg-language, group-title), allowing you to slice through thousands of channels instantly. |
| 💾 True Session Persistence | Safely auto-saves your preferences, custom stream sources, volume, and playback configurations using secure browser cookies. |
| 🛠 Universal Format Support | Natively plays HLS streams using the powerful hls.js engine, with adaptive bitrate/resolution selection, Data Saver mode, and an integrated fallback for native Apple/Safari devices. |
| 📡 Expandable Custom Sources | Ships with incredible global directories, plus allows dynamic adding/removing of your own .m3u URLs directly from the UI! |
| 📸 Built-in Snapshot Tool | Integrated canvas rendering module lets you take instant, high-quality screenshots of your favorite live TV moments. |
Want to run this beautiful application on your local machine or contribute to the codebase? It takes just seconds to spin up.
-
Clone the repository:
git clone https://github.com/namandhakad712/iptv-stream.git cd iptv-stream -
Install dependencies: (Note: This project leverages React 18 and Tailwind CSS v3)
npm install
-
Spin up the Vite Dev Server:
npm run dev
-
Experience the Magic: Open
http://localhost:5173/in your browser.
StreamOS includes a pre-configured vercel.json routing configuration out of the box to guarantee flawless SPA navigation.
- Create a free account at Vercel.
- Click Add New Project.
- Import this exact repository from your GitHub account.
- Leave all settings exactly as default (Vercel auto-detects
Viteand we have handled the rewrites). - Click Deploy.
Within 60 seconds, your own globally distributed IPTV app will be live on the edge.
StreamOS is entirely Open Source and community-driven! We welcome all contributions, from bug fixes and UI enhancements to whole new feature implementations.
- Fork the repository on GitHub.
- Clone your fork locally:
git clone https://github.com/YOUR_USERNAME/iptv-stream.git - Create a new branch for your feature:
git checkout -b feature/AmazingFeature - Make your changes and test them thoroughly using
npm run dev. - Commit your changes with descriptive commit messages:
git commit -m "Add some AmazingFeature" - Push to the branch:
git push origin feature/AmazingFeature - Open a Pull Request against the
mainbranch of this repository.
- Ensure your code follows the existing style and architecture (React functional components, Tailwind utility classes).
- If adding new icons, please use raw SVGs injected into our
Iconsobject withinapp.tsxto maintain zero-dependency UI rendering. - Test mobile responsiveness and dark-mode contrast before submitting UI changes.
StreamOS leverages the absolute full potential of massive, globally maintained open-source IPTV directories.
This powerful client natively taps into a globally unified directory of over 30,000+ public channels, pulling standard structures, APIs, and metadata to deliver the ultimate viewing pipeline.
Massive, profound acknowledgements to the following incredible open-source projects for meticulously maintaining these legal, vast public directories:
1. IPTV-Org & IPTV-Org API
The backbone of our global feed. IPTV-Org maintains a staggering collection of publicly available, legally free IPTV channels from all over the world. StreamOS directly integrates their master streams:
index.m3u(All 30k+ Channels globally)- Curated Global Categories (
movies.m3u,news.m3u,sports.m3u,music.m3u) - For developers: Explore their rich data sources at their API Documentation.
2. Free-TV
A beautifully and actively maintained list of completely free, public, and legal IPTV channels. We integrate their primary master lists natively.
A pivotal community resource maintaining deeply updated live endpoint .m3u8 lists for massive public broadcast television networks:
StreamOS is strictly a hobby project created exclusively for educational and frontend development purposes, specifically demonstrating complex React state management, dynamic UI rendering, and HLS video parsing capabilities.
This application does not host, store, download, cache, distribute, or broadcast any video media content. It acts purely as a dumb client-side web browser player that merely parses standard .m3u and .m3u8 text formats and feeds them to the browser's native <video> APIs.
All default IPTV playlist URLs bundled with this repository (linked above) are 100% free, public, and open-source.
Notice: If you believe any streamed content violates your copyright, please report or raise an issue directly with the respective third-party open-source playlist maintainers linked precisely above. This application possesses zero control over, and holds no affiliation with, any third-party media streams.
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ by Naman