Skip to content

Latest commit

 

History

History
174 lines (136 loc) · 11.9 KB

README.md

File metadata and controls

174 lines (136 loc) · 11.9 KB
Raw

Stream Bypass

A multi-browser addon / extension for multiple streaming providers which redirects directly to the source video.

Version Firefox Addon Store Chrome Store GitHub Downloads

Introduction 📝 • Installation 📥 • Features ✨ • Supported Websites 📜 • Building 🛠️ • Settings ⚙️ • License ⚖

📝 Introduction

This addon replaces the video player from this sides with the native player build-in into the browser or redirects directly to the source video. This has the advantage, that no advertising or popups are shown when trying to interact with the video (playing, skipping, ...) or some sites are showing them even if you do nothing. Additionally, this enables you to download the video by right-clicking it and just choose the download option.

How it's working:

📥 Installation

Official browser stores

The best way to install the extension are the official browser extension stores:

Manual installation

  • Firefox
    • Download stream-bypass-<version>-mv2.zip from the latest release and unzip it (with 7zip or something like that)
    • Go into your browser and type about:debugging#/runtime/this-firefox in the address bar
    • Click the Load Temporary Add-on... button and choose the manifest.json file in the unzipped directory
  • Chromium / Google Chrome

    As nearly every browser other than Firefox is based on Chromium, this should be the same for most of them

    • Download stream-bypass-<version>-mv3.zip from the latest release and unzip it (with 7zip or something like that)
    • Go into your browser and type chrome://extensions in the address bar
    • Turn on the developer mode by checking the switch in the top right corner
    • Click Load unpacked and choose the unzipped directory

✨ Features

Feature Firefox Chrome Firefox for Android
Replace site-speicifc video player with browser native video player ✔ ✔ ✔
Support websites that are accessed via a redirect ✔ ❌ ✔
Open video in mpv (with ff2mpv) ✔ ✔ ❌
  • ✔️: Supported.
  • ❌: Not supported.

📜 Supported websites

Site Firefox & Firefox for Android Chrome & Chromium based
dropload.io ✔ ✔
doodstream.com / dood.pm ✔️ ⚠ (redirect probably required)
filemoon.sx ✔ ✔
goodstream.uno ✔ ✔
mixdrop.co ✔ ️ ✔
mp4upload.com ✔ ✔
newgrounds.com ✔ ✔
streama2z.com ✔ ❌ (redirect always required)
streamtape.com ⚠ (correct video url can't always be extract, retrying/reloading the page might fix it) ⚠ (correct video url can't always be extract, retrying/reloading the page might fix it)
streamzz.to / streamz.ws ✔ ✔
supervideo.tv ✔ ✔
upstream.to ✔ ✔
vidmoly.me ✔ ✔
vidoza.net ⚠ (doesn't always work the first time, retrying/reloading the page one or two times fixes it) ⚠ (doesn't always work the first time, retrying/reloading the page one or two times fixes it)
voe.sx ✔ ❌ (redirect always required)
vupload.com ✔ ✔
kwik.cx ✔ ✔
  • ✔️: Everything ok.
  • ⚠: Works with limitations.
  • ❌: Not supported.

This table might not be 100% accurate, it isn't actively monitored if the addon works for every website!

Some sites put much effort in obfuscating their code / how they receive the video stream so that it simply cost too much time for me to reverse engineer it and find out how to bypass the native video player of the site.

🛠️ Building

If you want to build the addon from source and not using the installation way, follow the instructions.

Requirements:

  • npm installed.
  • A copy of this repository and a shell / console open in the copied directory.

If the requirements are satisfied, you can continue with the following commands:

# install all dependencies
$ npm install

# build the extension source to the dist/ directory
$ npm run build

# same as build + more optimizations and browser specific settings at release/
$ npm run release:firefox  # or "release:chrome" to create a release for chromium based browsers
Install

If you want to use the addon in Chromium or any browser which is based on it, follow the steps in installation. When using firefox, use the following:

  1. Type about:debugging in the browser's address bar.
  2. Select 'This Firefox' tab (maybe named different, depending on your language).
  3. Under Temporary Extensions, click Load Temporary Add-on.
  4. Choose any file in the directory where the compiled sources are.

⚙️ Settings

ff2mpv: use mpv to directly play streams

ff2mpv is located at this repository: https://github.com/woodruffw/ff2mpv

Steps to get it set up:

  • In the Usage section of the ff2mpv repository pick the installation instruction for your operating system (Linux/Windows/macOS; you do not need the browser addon).
  • Scroll down to Install manually
  • Follow instructions for Firefox/Chrome
  • Edit the ff2mpv.json you created:
    • Firefox: Add {55dd42e8-3dd9-455a-b4fe-86664881b10c} to allowed_extensions -> 
      "allowed_extensions": [
  "ff2mpv@yossarian.net",
  "{55dd42e8-3dd9-455a-b4fe-86664881b10c}"
]
    • Chrome/Chromium:
      • Go To: Settings -> Extensions
      • Click on Details of the Stream Bypass extension and copy the ID
      • Add chrome-extension://ddfpfjomnakfckhmilacnbokdaknamdb/ to allowed_origins -> 
        "allowed_origins": [
  "chrome-extension://ephjcajbkgplkjmelpglennepbpmdpjg/",
  "chrome-extension://ddfpfjomnakfckhmilacnbokdaknamdb/"
]

⚖ License

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