wvg/README.md

80 lines
2.3 KiB
Markdown
Raw Normal View History

2024-04-18 20:48:32 +00:00
## WVGuesserExtension-NextGen
Extension works standalone.
2024-04-19 20:11:39 +00:00
2024-04-18 20:48:32 +00:00
Not anymore need WVCore.Server API setup!
2024-04-08 22:58:09 +00:00
2024-04-20 03:09:36 +00:00
Looking for legacy version?: https://github.com/FoxRefire/wvg/tree/legacy
2024-04-19 20:11:39 +00:00
2024-04-08 22:58:09 +00:00
### Instalation
2024-04-22 13:12:01 +00:00
1. Download or clone this code
2024-04-22 12:05:09 +00:00
2. At the same directory of `manifest.json`(root directory of this extension), put the one of the following Android L3 CDM file(s).
* Supported CDM Types
1\. `device.wvd`
2\. `device_client_id_blob` + `device_private_key`
3\. `client_id.bin` + `private_key.pem`
2024-04-18 20:48:32 +00:00
3. Install extension
2024-04-08 22:58:09 +00:00
* Firefox
2024-04-11 17:07:41 +00:00
1\. Navigate to `about:debugging#/runtime/this-firefox`
2024-04-08 22:58:09 +00:00
2024-04-11 17:07:41 +00:00
2\. Load temporary addon
2024-04-08 22:58:09 +00:00
* Chrome
2024-04-10 19:45:12 +00:00
2024-04-11 17:07:41 +00:00
1\. Navigate to `chrome://extensions/`
2024-04-10 19:45:12 +00:00
2024-04-11 17:07:41 +00:00
2\. Load unpacked
2024-04-08 22:58:09 +00:00
2024-04-20 22:15:38 +00:00
* Kiwi Browser(Android)
2024-04-10 19:45:12 +00:00
2024-04-11 17:07:41 +00:00
1\. Navigate to ︙ --> Extensions
2024-04-10 19:45:12 +00:00
2024-04-11 17:07:41 +00:00
2\. \+(from .zip/.crx/.user.js)
2024-04-10 19:45:12 +00:00
2024-04-09 00:40:43 +00:00
### Demo
2024-05-04 16:50:14 +00:00
[Screencast_20240505_014046.webm](https://github.com/FoxRefire/wvg/assets/155989196/dbb07fde-a368-40f7-8209-711d5586009e)
2024-04-09 00:40:43 +00:00
2024-04-08 22:58:09 +00:00
### Todo
* Improve UI
2024-04-22 12:05:09 +00:00
* Localization
2024-05-04 16:50:14 +00:00
* Cache pyodide to make guessing process faster
2024-04-22 12:05:09 +00:00
For contributors, see here:
https://github.com/FoxRefire/wvg/blob/next/CONTRIBUTION.md
2024-04-08 22:58:09 +00:00
### Disclaimer
This extension is for educational and researchment purpose.
Only use it for content for which you own the rights and do not use it for piracy purposes.
2024-04-11 17:06:46 +00:00
### How it works?
2024-04-20 03:13:19 +00:00
![image](https://github.com/FoxRefire/wvg/assets/155989196/91a52607-9d24-4072-8c25-c4dc7d062415)
2024-04-20 03:09:36 +00:00
2024-04-11 17:06:46 +00:00
1. inject.js injected by content.js gets Widevine PSSH by hooking EME.
2. background.js fetches POST URLs/Headers
3. PSSHs will passed by this route inject.js-->content.js-->background.js-->popup.js
4. PSSHs+URLs+Headers will passed by this route background.js-->popup.js
5. popup.js will contols UI(popup.html)
6. User input into UI
2024-04-20 03:09:36 +00:00
7. popup.js calls pywidevine script using pyodide in browser
2024-04-24 18:37:31 +00:00
## Third-party libraries
2024-04-24 19:11:11 +00:00
* [Pyodide](https://github.com/pyodide/pyodide) ([MPL-2.0](https://github.com/pyodide/pyodide/blob/main/LICENSE))
* [Pywidevine](https://github.com/devine-dl/pywidevine) ([GPL-3.0](https://github.com/devine-dl/pywidevine/blob/master/LICENSE))
* [json-view](https://github.com/pgrabovets/json-view) ([MIT](https://github.com/pgrabovets/json-view/blob/master/LICENSE))
2024-04-24 18:37:31 +00:00
2024-04-20 03:09:36 +00:00
### Big Thanks and inspired by
https://github.com/emarsden/pssh-box-wasm/