Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wyzuk Cast 📺

Wyzuk Cast Logo

⚡ Wyzuk Cast

Modern, High-Performance IPTV Web Streaming Player

Watch Live GitHub stars GitHub forks License: MIT Deployed on Vercel

An open-source, Apple-inspired IPTV web streaming application designed for speed, beauty, and seamless live television playback.

Explore Live App »  •  About Us  •  Features  •  Shortcuts  •  Quick Start  •  Community


📖 About Us

Welcome to Wyzuk Cast — an open-source media streaming initiative founded and maintained by Wyzuk.

🌟 Who We Are

We are passionate developers, open-source enthusiasts, and digital media advocates dedicated to crafting elegant, ultra-responsive, and accessible web experiences. We believe that accessing live global television, news, entertainment, and educational broadcasts should be simple, lightweight, and free from intrusive ads, bloated client software, or paywalls.

🎯 Our Mission

Our mission with Wyzuk Cast is to deliver a best-in-class, browser-native IPTV player that combines cutting-edge web streaming technology (HLS.js) with an Apple-inspired glassmorphic aesthetic. We want to empower anyone with an internet connection to discover, organize, and enjoy live channels from around the world without needing to install proprietary apps or third-party plugins.

💎 Core Values & Philosophy

  • 🚀 Zero-Friction Streaming: Instant startup times, client-side M3U playlist parsing, and automatic playback recovery.
  • 🎨 Premium Craftsmanship: Clean dark mode, glowing cyan-blue accents, smooth micro-interactions, and accessible typography powered by Plus Jakarta Sans.
  • 🌐 Open Source & Community-Driven: Transparent codebase, welcoming contributions, and community playlist updates.
  • 🔒 Privacy First: No invasive trackers, no user telemetry, and no account requirements — your streaming session stays strictly on your device.

✨ Features

  • ⚡ Native HLS Live Streaming: Powered by HLS.js for low-latency live streams, buffer management, and automatic error handling.
  • 🔍 Instant Channel Search & Filters: Lightning-fast real-time search across thousands of channels by name or category.
  • 🗂️ Dynamic Category Carousel: Filter effortlessly through News, Sports, Entertainment, Movies, Music, Kids, Regional, and more.
  • 🖼️ Picture-in-Picture (PiP) & Fullscreen: Multitask while watching your favorite channel in a floating window or switch to distraction-free fullscreen mode.
  • ⌨️ Power-User Keyboard Navigation: Comprehensive hotkeys for toggling playback, changing channels, muting audio, and quick search.
  • 📱 Fully Responsive Glassmorphic UI: Tailored for desktops, laptops, tablets, and smartphones with fluid layouts.
  • 🔄 Infinite Batch Rendering: Uses the IntersectionObserver API to lazily render channels on-demand, ensuring smooth performance even with huge playlist files.
  • 🛡️ Custom Channel Fallbacks: Smart initials and placeholder avatars for channels without custom logos.

🎮 Keyboard Shortcuts

Boost your streaming experience with built-in hotkeys:

Shortcut Action Description
Space Play / Pause Toggle video playback for current channel
F Fullscreen Toggle full-screen player mode
M Mute / Unmute Toggle audio volume mute
] Next Channel Switch to the next channel in the list
[ Previous Channel Switch to the previous channel in the list
/ Quick Search Jump directly into the channel search bar
Esc Exit Search / Dismiss Clear search focus or close active modals

🛠️ Tech Stack

Wyzuk Cast is built with clean, modern, zero-bloat web standards:

  • Frontend: Vanilla HTML5, Modern CSS3 (CSS Custom Properties, Glassmorphism, Flexbox/Grid)
  • Logic: Vanilla JavaScript (ES6+ Modules, Intersection Observer API, Fullscreen API, PiP API)
  • Streaming Engine: HLS.js
  • Typography: Plus Jakarta Sans by Google Fonts
  • Deployment & Hosting: Vercel

🚀 Getting Started

Follow these steps to run Wyzuk Cast locally on your machine:

Prerequisites

All you need is a modern web browser (Google Chrome, Mozilla Firefox, Microsoft Edge, Apple Safari, Brave, etc.) and a local web server.

Installation

  1. Clone the repository:

    git clone https://github.com/wyzuk/wyzukcast.git
    cd wyzukcast
  2. Run a local development server:

    Using Node.js (npx serve):

    npx serve .

    Or using Python 3:

    python -m http.server 3000

    Or using VS Code Live Server extension:

    • Right-click index.html and click "Open with Live Server".
  3. Open in browser:

    • Navigate to http://localhost:3000 (or the port specified by your local server).

📋 Custom Playlist Configuration

Wyzuk Cast reads channels from tv.txt (a standard M3U / EXTINF playlist format).

To use your own channels or update the playlist:

  1. Open tv.txt in the root directory.
  2. Add your custom channels in standard M3U format:
    #EXTINF:-1 tvg-logo="https://example.com/logo.png" group-title="News", Channel Name
    https://example.com/live/stream.m3u8
  3. Save the file and reload the application!

🤝 Contributing & Community

We welcome contributions of all kinds! Whether you want to fix a bug, suggest new features, improve UI accessibility, or help curate working stream sources:

  1. Fork the Project (https://github.com/wyzuk/wyzukcast/fork)
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

If you encounter a broken stream or have an idea, feel free to open an Issue on GitHub.


📬 Connect With Us


⚖️ Disclaimer

Wyzuk Cast is solely a frontend media player software application. It does not host, store, broadcast, or transmit any proprietary audio or video content directly. All channel streams and metadata are fetched from publicly accessible M3U playlist endpoints provided by the community.

Please ensure you comply with your local laws and regulations regarding media consumption and intellectual property rights when using any IPTV streaming source.


📄 License

Distributed under the MIT License. See LICENSE for more details.

Built with ❤️ by Wyzuk and contributors worldwide.

About

Open-source, lightweight IPTV web player with M3U/M3U8 support, channel categories, logos, search, and a clean modern UI.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages