stream-bypass/README.md

3.7 KiB

Stream Bypass

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

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.

Supported streaming providers (for a complete list of all supported websites, see here):

How it's working

The addon was tested on

  • Firefox (94.0b9)
  • Ungoogled Chromium (94.0)
  • Vivaldi (4.3)
  • Opera (80.0)

Installing

Firefox

Install the addon directly from the firefox addon store.

Chromium / Google Chrome

  1. Download the stream-bypass-<version>.zip file from the latest release and unzip it (with 7zip or something like that).
  2. Go into your browser and type chrome://extensions in the address bar.
  3. Turn the developer mode in the top right corner on.
  4. Click Load unpacked.
  5. Choose the cloned / unzipped directory.

Opera

  1. Download the stream-bypass-<version>.zip file from the latest release and unzip it (with 7zip or something like that).
  2. Go into your browser and type opera://extensions in the address bar.
  3. Turn the developer mode in the top right corner on.
  4. Click Load unpacked.
  5. Choose the cloned / unzipped directory.

Compiling

If you want to use / install the addon from source, you have to compile the typescript and sass files yourself.

Manual

For compiling everything bare bones, you need typescript and sass installed.

  • Compile typescript
    $ tsc -p src
    
  • Compile sass (replace <path to sass file> with every .sass file in the src directory)
    $ sass --no-source-map <path to sass file>
    

The compiled output will be in the src directory.

If you want to keep it a little cleaner, you additionally need python3.

  • Compile everything with one line
    $ python3 build.py -b -c
    

The compiled output will remain in a (new created if not existing) build directory.

Docker

For this, you need docker to be installed.

  • Build the docker image
    $ docker build -t stream-bypass .
    
  • Compile
    $ docker run --rm -v build:/build stream-bypass
    

The compiled output will remain in a (new created if not existing) build directory.

Install

If you want to use the addon in Chromium or any browser which is based on it (almost every other, Google Chrome, Opera, ...), follow the steps in installing. 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.

License

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