Stream Bypass

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

Introduction 📝 • Installation 📥 • Supported Sites 📜 • 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:

• Firefox Addon Store
• Chrome Web Store

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

📜 Supported sites

• ✔️: Everything ok.
• ⚠: Included in the addon but will probably not work. See Note in this case, an explanation why will stand there in the most cases.
• ❌: Not included / supported by the addon. This can have various reasons. See Note for an explanation.

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": [
      "[email protected]",
      "{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://your-id-here/ to allowed_origins ->

      "allowed_origins": [
        "chrome-extension://ephjcajbkgplkjmelpglennepbpmdpjg/",
        "chrome-extension://your-id-her/"
      ]
      

⚖ License

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