Documentation
Find a reference for every piece of the Dodge toolkit.
Just want to use Dodge? See install. New to video fingerprinting? Start with learn.
The Dodge toolkit
The dash.js module runs defenses inside the video player itself, reshaping a video's HTTP request/response sequence. Integration into the dash.js player is currently being reviewed in pull request #5021 .
The browser extension (Firefox, Chrome, and Edge), still in development, will let viewers use Dodge even when content providers haven't configured it. It includes a safe player, in-page swap, a built-in defense generator, and a verifier that checks and visualizes a defense.
The defense generator creates extended manifests from a plain DASH MPD.
It's included in the extension and is also available standalone at /tools/generator.
The extended manifest format ties these tools together: it's the JSON format that defenses are expressed in. The defense generator produces it, and the dash.js module and browser extension read it to apply a defense.
Which doc do I need?
| I want to... | Where to look |
|---|---|
| Integrate Dodge on my site | dash.js module docs: integration guide and settings reference |
| Understand or configure the extension | Browser extension docs are still being written; install covers setup in the meantime |
| Pick a defense to use | Choosing a defense |
| Write or generate defenses | Defense development and the extended manifest format |
| Learn about the threat model | Threat model & security |
| Read the Dodge paper | Research |
| Contribute code | Contributing & development |