Skip to content

USAGE.md

Latest commit

 

History

History
110 lines (73 loc) · 3.31 KB

USAGE.md

File metadata and controls

110 lines (73 loc) · 3.31 KB

Web IPTV Player Chrome Extension – Usage Guide

Welcome to the Web IPTV Player Chrome Extension!
This guide will help you get started and make the most of its features.

🚀 Getting Started

  1. Install the Extension

    • Download the .zip from the GitHub Releases.
    • Unzip the folder.
    • Go to chrome://extensions in your browser.
    • Enable "Developer mode" (top right).
    • Click "Load unpacked" and select the unzipped extension folder.

  2. Open the Player

    • Click the extension icon in your Chrome toolbar.
    • The IPTV web player window will open.

📁 Loading Playlists

You can load playlists in several ways:

Upload a Local Playlist File

  • Click the "Choose File" button in the sidebar.
  • Supported formats: .m3u, .json, .txt.
  • Select your IPTV playlist file from your computer.

Load by URL

  • Paste a playlist URL (supports .m3u, .json, .txt, or direct video streams) into the "Enter stream URL" box.
  • Click the Play button.

Direct Stream

  • You can also paste a direct video stream (.m3u8, .mpd, .mp4, etc.) URL for instant playback.

🔎 Features Overview

Sidebar Tabs

  • Channels: Browse and play channels from your loaded playlist.
  • History: Quickly reload previously loaded playlists/streams.
  • Favorites: Manage your favorite channels. Click the heart icon to add/remove.
  • Analysis: View playlist stats (total, online, offline channels) and visualize with a chart.

Searching

  • Use the search bar to filter channels by name.

Theme Toggle

  • Switch between dark and light mode using the moon/sun icon at the top.

Sidebar Toggle

  • Hide/show the sidebar for a larger video view.

Favorites Export

  • Export your favorite channels as a .m3u playlist for backup or sharing.

Manual Playlist Check

  • In the Analysis tab, click the check-circle icon to manually check the status of all channels.

History Management

  • In the History tab:
    • Reload any previous playlist or stream.
    • Remove individual entries with the trash icon.
    • Clear all history with the Delete All button.

🖥️ Supported Media Types

  • Playlists: M3U, JSON, TXT
  • Streams: HLS (.m3u8), MPEG-DASH (.mpd), MP4, and more

📝 Tips

  • Encrypted Links: The extension uses encrypted URLs in the address bar for secure sharing.
  • Drag & Drop: You can drag and drop files into the file input for quick upload.
  • Responsive: Works on various screen sizes, including tablets.

❓ Troubleshooting

  • Streams Not Loading: Check that the stream URL is correct and accessible from your network.
  • Images Not Displayed: Some channel logos may not load due to remote server issues.
  • CSP Errors: No inline JS is used; if you see CSP errors, please update to the latest version.

🛡️ Privacy & Security

  • All data is stored locally in your browser and not sent anywhere.
  • No tracking or analytics.
  • Open source for full transparency.

❤️ Feedback & Contributions

  • Found a bug? Have a feature request?
    Open an issue or send a pull request!

Enjoy your IPTV experience!