mirror of
https://github.com/bytedream/stream-bypass.git
synced 2025-05-09 12:15:14 +02:00
177 lines
12 KiB
Markdown
177 lines
12 KiB
Markdown
# Stream Bypass
|
||
|
||
A multi-browser addon / extension for multiple streaming providers which redirects directly to the source video.
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/bytedream/stream-bypass/releases/latest">
|
||
<img src="https://img.shields.io/github/v/release/ByteDream/stream-bypass?label=Version&style=flat-square" alt="Version">
|
||
</a>
|
||
<a href="https://addons.mozilla.org/de/firefox/addon/stream-bypass/">
|
||
<img src="https://img.shields.io/amo/users/stream-bypass?label=Firefox%20Users&style=flat-square" alt="Firefox Addon Store">
|
||
</a>
|
||
<a href="https://chromewebstore.google.com/detail/ddfpfjomnakfckhmilacnbokdaknamdb">
|
||
<img src="https://img.shields.io/chrome-web-store/users/ddfpfjomnakfckhmilacnbokdaknamdb?style=flat-square&label=Chrome%20Users" alt="Chrome Store">
|
||
</a>
|
||
<a href="https://github.com/bytedream/stream-bypass/releases/latest">
|
||
<img src="https://img.shields.io/github/downloads/ByteDream/stream-bypass/total?label=GitHub%20Downloads&style=flat-square" alt="GitHub Downloads">
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="#-introduction">Introduction 📝</a>
|
||
•
|
||
<a href="#-installation">Installation 📥</a>
|
||
•
|
||
<a href="#-features">Features ✨</a>
|
||
•
|
||
<a href="#-supported-websites">Supported Websites 📜</a>
|
||
•
|
||
<a href="#%EF%B8%8F-building">Building 🛠️</a>
|
||
•
|
||
<a href="#%EF%B8%8F-settings">Settings ⚙️</a>
|
||
•
|
||
<a href="#-license">License ⚖</a>
|
||
</p>
|
||
|
||
## 📝 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.
|
||
|
||
<details id="example">
|
||
<summary><b>How it's working:</b></summary>
|
||
<img src="example.gif" alt="">
|
||
</details>
|
||
|
||
## 📥 Installation
|
||
|
||
### Official browser stores
|
||
|
||
The best way to install the extension are the official browser extension stores:
|
||
|
||
- [Firefox Addon Store](https://addons.mozilla.org/de/firefox/addon/stream-bypass/) (Firefox for Android is supported too!)
|
||
- [Chrome Web Store](https://chromewebstore.google.com/detail/ddfpfjomnakfckhmilacnbokdaknamdb)
|
||
|
||
### Manual installation
|
||
|
||
- Firefox
|
||
- Download `stream-bypass-<version>-mv2.zip` from the [latest release](https://github.com/ByteDream/stream-bypass/releases/latest) and unzip it (with [7zip](https://www.7-zip.org/) 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](https://github.com/ByteDream/stream-bypass/releases/latest) and unzip it (with [7zip](https://www.7-zip.org/) 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](https://github.com/ByteDream/stream-bypass/tree/master#ff2mpv-use-mpv-to-directly-play-streams)) | ✔ | ✔ | ❌ |
|
||
|
||
- ✔️: Supported.
|
||
- ❌: Not supported.
|
||
|
||
## 📜 Supported websites
|
||
|
||
| Site | Firefox & Firefox for Android | Chrome & Chromium based |
|
||
| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
||
| [dropload.io](https://dropload.io) | ✔ | ✔ |
|
||
| [doodstream.com](doodstream.com) / [dood.pm](https://dood.pm) | ✔ | ⚠ (redirect probably required) |
|
||
| [filemoon.to](https://filemoon.to) | ✔ | ✔ |
|
||
| [goodstream.uno](https://goodstream.uno) | ✔ | ✔ |
|
||
| [kwik.cx](https://kwik.cx) | ✔ | ✔ |
|
||
| [loadx.ws](https://loadx.ws) | ✔ | ❌ (background request always required) |
|
||
| [luluvdo.com](https://luluvdo.com) | ✔ | ❌ (background request always required) |
|
||
| [mixdrop.co](https://mixdrop.co) | ✔ ️ | ✔ |
|
||
| [mp4upload.com](https://mp4upload.com) | ✔ | ✔ |
|
||
| [newgrounds.com](https://newgrounds.com) | ✔ | ✔ |
|
||
| [streama2z.com](https://streama2z.com) | ✔ | ❌ (redirect always required) |
|
||
| [streamtape.com](https://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](https://streamzz.to) / [streamz.ws](https://streamz.ws) | ✔ | ✔ |
|
||
| [supervideo.tv](https://supervideo.tv) | ✔ | ✔ |
|
||
| [upstream.to](https://upstream.to) | ✔ | ✔ |
|
||
| [vidmoly.to](https://vidmoly.me) | ✔ | ✔ |
|
||
| [vidoza.net](https://vidoza.net) | ✔ | ✔ |
|
||
| [voe.sx](https://voe.sx) | ✔ | ❌ (redirect always required) |
|
||
| [vupload.com](https://vupload.com) | ✔ | ✔ |
|
||
|
||
- ✔️: 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](#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:
|
||
|
||
```shell
|
||
# 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](#-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
|
||
|
||
### <ins>ff2mpv: use mpv to directly play streams</ins>
|
||
|
||
ff2mpv is located at this repository: https://github.com/woodruffw/ff2mpv
|
||
|
||
Steps to get it set up:
|
||
|
||
- In the [Usage](https://github.com/woodruffw/ff2mpv#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](LICENSE) file for more details.
|