wvg/README.md

WVGuesserExtension-NextGen

Extension works standalone.

Not anymore need WVCore.Server API setup!

Looking for legacy version?: https://github.com/FoxRefire/wvg/tree/legacy

Instalation

1. Download or clone this code

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

3. Install extension

   • Firefox

     1. Navigate to about:debugging#/runtime/this-firefox

     2. Load temporary addon

   • Chrome

     1. Navigate to chrome://extensions/

     2. Load unpacked

   • Kiwi Browser(Android)

     1. Navigate to ︙ --> Extensions

     2. +(from .zip/.crx/.user.js)

Demo

Screencast_20240505_014046.webm

Todo

• Improve UI
• Localization
• Cache pyodide to make guessing process faster

For contributors, see here: https://github.com/FoxRefire/wvg/blob/next/CONTRIBUTION.md

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.

How it works?

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
7. popup.js calls pywidevine script using pyodide in browser

Third-party libraries

• Pyodide (MPL-2.0)
• Pywidevine (GPL-3.0)
• json-view (MIT)

Big Thanks and inspired by

https://github.com/emarsden/pssh-box-wasm/