Stream to Android Player Autor: Faisal Bhuiyan

A browser extension to detect streaming videos (M3U8, MP4) and send them to your preferred media player on Android and Windows. Supports VLC, MPV, and other players with command-line arguments.

Changelog
1.4
- Fix Native Host Messaging not launching streams or python script.
- Fix icons not appearing in some websites.
- Instantly apply popup settings. No need to reload page.
1.3
- Added Desktop support.
- Add web video player, copy URL, and ability to open in external video player features to desktop.
- Native Host messaging requires additional setup. Stay tuned for instructions.
1.2
- Fixed overheating, high resource usage issues.
- Added better styling.
- Added popup UI to configure settings.
- Streams show duration (if found).
1.1
- Added multiple streaming detection methods
- Successfully detects streams from sites that were not detected in 1.0
1.0
- Initial release
- Detects streaming videos from many sites successfuly.
- Fails in few sites.

Features
Stream Detection
- Detects streaming formats: M3U8 (HLS), MP4, DASH (MPD), MPEG-TS, WebM, H.264/AVC, H.265/HEVC.
- Extracts video sources from <video> and <source> tags.
- Filters non-video URLs (e.g., data:, blob:).
- Supports quality detection (e.g., 1080p, 4K) via URL patterns.

Player Support
- Android: VLC, MX Player, and other players via Web Share API.
- Desktop: VLC, MPV, and other players via:
- Native Messaging (browser-to-app communication).
- Protocol Handlers (e.g., vlc://, mpv://).
- VLC HTTP Interface (remote control).
- In-Browser Playback: Shaka Player (HLS/DASH/MP4) and Vidstack.

Platform Support
- Android: Web Share API integration.
- Desktop: Windows, macOS, Linux (native messaging/protocol handlers).
- Browsers: Chrome, Firefox, Edge.

UI/UX
- Toolbar Icon: Quick access to extension settings.
- Popup UI:
- Toggle extension on/off.
- Configure whitelists/blacklists for domains.
- Set maximum stream count (e.g., limit to 5 streams).
- Customize default actions (e.g., "Share" on Android, "Copy" on Desktop).
- Stream Menu:
- Displays detected streams with quality badges (e.g., "1080p").
- Shows duration (if available).
- Supports keyboard shortcuts (e.g., fullscreen).
- Notifications: Alerts for errors (e.g., failed player launches).

Customization
- Player Preferences: Choose VLC, MPV, or custom player paths.
- Keyboard Shortcuts: Fullscreen, play/pause, volume control (in-browser player).
- Advanced Options:
- Subtitles: Supported via Shaka Player (WebVTT, TTML).
- Quality Selection: Auto-detected from stream metadata.
- Casting: Indirectly supported via external players (e.g., VLC Chromecast).

Installation
1. Browser Extension:
- Download the latest release from Firefox Store.

1. Native Host Setup (Required for desktop):
2. Download the Native Host zip from GitHub Releases.
3. Follow the setup instructions below for your OS.

Usage
1. Navigate to a webpage with a streaming video.
2. Click the extension icon in the toolbar.
3. Select the detected stream from the list.
4. Choose your preferred media player from the sharing menu (Android) or let the native host open it directly (desktop).

Native Host Setup
The native host is required to open streams directly in VLC, MPV, or other players on desktop.

Windows
1. Download the Native Host zip from GitHub Releases.
2. Extract the zip file.
3. Run the install_host.bat file as Administrator.
4. Restart your browser.

Supported Players
- VLC: Works out of the box.
- MPV: Works out of the box.
- Other Players: May work if they support the same command-line arguments as VLC/MPV.

Troubleshooting
Extension Issues
- Extension icon not appearing:
- Ensure the extension is loaded correctly in Developer Mode.
- Refresh the webpage or restart the browser.

• Streams not detected:
• The website may use a non-standard format (e.g., DRM-protected streams).
• Check the extension popup for error logs.
• Try whitelisting the domain in settings.
• Popup UI not responding:
• Disable and re-enable the extension.
• Clear browser cache and reload.

Player Issues
- Android (Web Share API):
- Ensure VLC/MX Player is installed.
- Grant storage permissions to the player app.
- Restart the browser if sharing fails.

• Desktop (Native Host):
• Ensure the native host is installed (check chrome://extensions or about:addons).
• Verify browser permissions for native messaging.
• Restart the browser and system if needed.
• VLC/MPV not launching:
• Check if the player path is correct in extension settings.
• Ensure protocol handlers (e.g., vlc://) are registered.
• For VLC HTTP Interface, verify the password in settings.
• In-Browser Playback:
• Ensure Shaka Player/Vidstack is enabled in settings.
• Check for CORS errors in the browser console.