CONTRIBUTING Copy Section

Contributing to Clappr

Thanks for your interest in Clappr. This guide covers how to report issues, propose changes, and submit pull requests.

Please read and follow our Code of Conduct.

Did you find a bug? Copy Chapter

- Search first on Issues to see if it was already reported.
- If not, open a new issue via New issue and choose Bug Report.
- Include as much detail as you can: player version, browser, OS, configuration, and steps to reproduce.

Do you have a question? Copy Chapter

- Check the FAQ first.
- If you still need help, open New issue and choose Question.

Do you want a new feature? Copy Chapter

- Open New issue and choose Feature Request before starting large work.
- Describe the problem and the solution you have in mind so maintainers can discuss scope early.
- We may decline changes that significantly increase bundle size or hurt streaming performance.

Did you write a patch? Copy Chapter

1. Fork the repository and create a branch from main.
2. Make your changes and keep the pull request focused.
3. Open a pull request with a clear description of the problem and solution.
4. Link the related issue when applicable.

Before submitting, make sure CI checks pass locally:

yarn test
yarn lint
yarn format:check
yarn build:dist && yarn test:smoke

Development setup Copy Chapter

Requires Node.js ≥ 24 (see .nvmrc; with nvm, run nvm install then nvm use before any yarn command). Yarn 1 enforces the root engines field and aborts every yarn command on older Node versions — including yarn lint, yarn test, and yarn format:check above.

Shared tooling (Babel, ESLint, browserslist, and any dependency used by 2+ packages) lives at the workspace root — see Dependencies and shared config in AGENTS.md before adding or bumping a tool.

See the README for:

- Local Development
- Project Structure
- Documentation

Commit messages Copy Chapter

Use Conventional Commits:

type(scope): description

Examples: fix(core): restore volume after unmute, docs(player): clarify autoplay options.

Commit messages are validated by commitlint via Husky.

Coding expectations Copy Chapter

- Follow ESLint and Prettier (run yarn lint and yarn format:check).
- Test behavior, not implementation details.
- Clean up timers, listeners, observers, connections, media elements, and Blob URLs.
- Do not commit secrets, tokens, or .env files.
- Ask maintainers before adding new dependencies — bundle size and maintenance matter in a media player.
- Sourcemaps: an artifact in dist/ gets a map iff it is a package/exports entry, a documented consumer entry point, or minified — see Releasing → Sourcemaps.

Documentation and plugins Copy Chapter

Documentation lives under apps/clappr.io/docs/. See the README Documentation section for the full index.

To build a plugin, start with the Plugin Development Guide.

License Copy Chapter

By contributing, you agree that your contributions will be licensed under the BSD 3-Clause License.

---

README Copy Section

Clappr

An extensible, plugin-oriented, HTML5-first media player for the web.
It provides a modular architecture to build powerful playback experiences with ease.

[](https://github.com/clappr/clappr/actions/workflows/ci.yml)
[](https://raw.githubusercontent.com/clappr/clappr/main/packages/player/package.json)
[](https://github.com/clappr/clappr/blob/main/LICENSE)
[](https://bundlephobia.com/package/@clappr/player)
[](https://www.jsdelivr.com/package/npm/@clappr/player)

Getting Started Copy Chapter

Install via npm or yarn:

yarn add @clappr/player

Breaking changes (playback peers) Copy Chapter

Recent majors stopped embedding their streaming libraries — you must provide the peer:

| Package | Major | Change |
| ------- | ----- | ------ |
| @clappr/hlsjs-playback | 3.0.0 | hls.js no longer bundled |
| dash-shaka-playback | 5.0.0 | shaka-player no longer bundled |

Project Structure Copy Chapter

This repository uses a monorepo layout:

| Directory | Description |
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| /apps | Applications such as clappr.io and documentation site |
| /packages | Core packages (e.g. @clappr/player, plugins, utilities) |
| /packages/player | The main Clappr Player package. Exposes the public API and serves as the entry point for embedding the player in web apps. |
| /packages/clappr-core | Contains the core architecture of the player — including components such as Core, Container, and Playback abstractions. |
| /packages/clappr-plugins | Official plugin collection, providing ready-to-use extensions (e.g., UI features, analytics integrations). |
| /packages/clappr-zepto | Lightweight DOM utility layer, a modernized fork of Zepto tailored for Clappr’s internal UI rendering. |
| /packages/hlsjs-playback | Playback module that adds support for HLS streams using hls.js. |
| /packages/dash-shaka-playback | Playback module that enables MPEG-DASH streaming via Shaka Player. |
| /packages/html5-tvs-playback | Playback module for HbbTV smart TVs, supporting VoD/Live and DRM via the OIPF DRM agent. |

Documentation Copy Chapter

For the latest guides, examples, and architecture overviews, visit the resources below:

- Getting Started: quick setup and integration examples.
- Architecture Overview: explains how the player, core, containers, and plugins interact.
- Plugin Development Guide: how to create and register custom plugins.
- Player API Reference: complete reference of all available Player methods and properties.
- Frequently Asked Questions: answers to commonly asked questions about setup, configuration, and troubleshooting.
- Changelog: highlights of each version and breaking changes.

Local Development Copy Chapter

Requires Node.js ≥ 24. The repo pins the major version in .nvmrc; with nvm, run nvm install then nvm use in the project root before any yarn command. Yarn 1 aborts every yarn command when the engine check fails.

Clone the repository and run:

Install dependencies

yarn install
Start the development environment

yarn dev
Open in your browser

http://localhost:8080

Contributing Copy Chapter

We welcome contributions. See CONTRIBUTING.md for how to report bugs, propose features, and submit pull requests. Please follow our Code of Conduct.

Contributors Copy Chapter

Thanks to all our amazing contributors! 🎉

<table>
<tbody>
<tr>
<td align="center">
<a href="https://github.com/towerz">
<img src="https://avatars.githubusercontent.com/u/989801?v=4" width="100;" alt="towerz"/>
<br />
_{<b>towerz</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/flavioribeiro">
<img src="https://avatars.githubusercontent.com/u/244265?v=4" width="100;" alt="flavioribeiro"/>
<br />
_{<b>flavioribeiro</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/leandromoreira">
<img src="https://avatars.githubusercontent.com/u/55913?v=4" width="100;" alt="leandromoreira"/>
<br />
_{<b>leandromoreira</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/joaopaulovieira">
<img src="https://avatars.githubusercontent.com/u/5631063?v=4" width="100;" alt="joaopaulovieira"/>
<br />
_{<b>joaopaulovieira</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/tjenkinson">
<img src="https://avatars.githubusercontent.com/u/3259993?v=4" width="100;" alt="tjenkinson"/>
<br />
_{<b>tjenkinson</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/jhonatangcavalcanti">
<img src="https://avatars.githubusercontent.com/u/14154066?v=4" width="100;" alt="jhonatangcavalcanti"/>
<br />
_{<b>jhonatangcavalcanti</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/leaofelipe">
<img src="https://avatars.githubusercontent.com/u/1847691?v=4" width="100;" alt="leaofelipe"/>
<br />
_{<b>leaofelipe</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/tchakabam">
<img src="https://avatars.githubusercontent.com/u/1480052?v=4" width="100;" alt="tchakabam"/>
<br />
_{<b>tchakabam</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/kslimani">
<img src="https://avatars.githubusercontent.com/u/1758996?v=4" width="100;" alt="kslimani"/>
<br />
_{<b>kslimani</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/thiagopnts">
<img src="https://avatars.githubusercontent.com/u/322239?v=4" width="100;" alt="thiagopnts"/>
<br />
_{<b>thiagopnts</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/dayvson">
<img src="https://avatars.githubusercontent.com/u/59447?v=4" width="100;" alt="dayvson"/>
<br />
_{<b>dayvson</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/pedrochamberlain">
<img src="https://avatars.githubusercontent.com/u/40682476?v=4" width="100;" alt="pedrochamberlain"/>
<br />
_{<b>pedrochamberlain</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/bikegriffith">
<img src="https://avatars.githubusercontent.com/u/167782?v=4" width="100;" alt="bikegriffith"/>
<br />
_{<b>bikegriffith</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/vagnervjs">
<img src="https://avatars.githubusercontent.com/u/1696024?v=4" width="100;" alt="vagnervjs"/>
<br />
_{<b>vagnervjs</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/barbosa">
<img src="https://avatars.githubusercontent.com/u/235208?v=4" width="100;" alt="barbosa"/>
<br />
_{<b>barbosa</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/felipecesr">
<img src="https://avatars.githubusercontent.com/u/10980841?v=4" width="100;" alt="felipecesr"/>
<br />
_{<b>felipecesr</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/fecampi">
<img src="https://avatars.githubusercontent.com/u/58281716?v=4" width="100;" alt="fecampi"/>
<br />
_{<b>fecampi</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/ronag">
<img src="https://avatars.githubusercontent.com/u/3065230?v=4" width="100;" alt="ronag"/>
<br />
_<b>ronag</b>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/andrefilimono">
<img src="https://avatars.githubusercontent.com/u/7794526?v=4" width="100;" alt="andrefilimono"/>
<br />
_{<b>andrefilimono</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/paluh">
<img src="https://avatars.githubusercontent.com/u/190249?v=4" width="100;" alt="paluh"/>
<br />
_<b>paluh</b>
</a>
</td>
<td align="center">
<a href="https://github.com/davidjb">
<img src="https://avatars.githubusercontent.com/u/1002811?v=4" width="100;" alt="davidjb"/>
<br />
_{<b>davidjb</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/NicholasAsimov">
<img src="https://avatars.githubusercontent.com/u/8828810?v=4" width="100;" alt="NicholasAsimov"/>
<br />
_{<b>NicholasAsimov</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/gamtiq">
<img src="https://avatars.githubusercontent.com/u/1177323?v=4" width="100;" alt="gamtiq"/>
<br />
_{<b>gamtiq</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/afonsocdaniel">
<img src="https://avatars.githubusercontent.com/u/1382338?v=4" width="100;" alt="afonsocdaniel"/>
<br />
_{<b>afonsocdaniel</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/leftees">
<img src="https://avatars.githubusercontent.com/u/12038092?v=4" width="100;" alt="leftees"/>
<br />
_{<b>leftees</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/hounvs">
<img src="https://avatars.githubusercontent.com/u/6434904?v=4" width="100;" alt="hounvs"/>
<br />
_{<b>hounvs</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/ariselseng">
<img src="https://avatars.githubusercontent.com/u/445843?v=4" width="100;" alt="ariselseng"/>
<br />
_{<b>ariselseng</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/guilhermebruzzi">
<img src="https://avatars.githubusercontent.com/u/1321766?v=4" width="100;" alt="guilhermebruzzi"/>
<br />
_{<b>guilhermebruzzi</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/stanogurnik">
<img src="https://avatars.githubusercontent.com/u/2771618?v=4" width="100;" alt="stanogurnik"/>
<br />
_{<b>stanogurnik</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/amanda-bmelo">
<img src="https://avatars.githubusercontent.com/u/48109161?v=4" width="100;" alt="amanda-bmelo"/>
<br />
_{<b>amanda-bmelo</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/michaelcunningham19">
<img src="https://avatars.githubusercontent.com/u/10078342?v=4" width="100;" alt="michaelcunningham19"/>
<br />
_{<b>michaelcunningham19</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/rheber">
<img src="https://avatars.githubusercontent.com/u/7068967?v=4" width="100;" alt="rheber"/>
<br />
_{<b>rheber</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/luanraithz">
<img src="https://avatars.githubusercontent.com/u/27583162?v=4" width="100;" alt="luanraithz"/>
<br />
_{<b>luanraithz</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/mrlika">
<img src="https://avatars.githubusercontent.com/u/1469266?v=4" width="100;" alt="mrlika"/>
<br />
_{<b>mrlika</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/breim">
<img src="https://avatars.githubusercontent.com/u/4550114?v=4" width="100;" alt="breim"/>
<br />
_<b>breim</b>
</a>
</td>
<td align="center">
<a href="https://github.com/sjlu">
<img src="https://avatars.githubusercontent.com/u/329917?v=4" width="100;" alt="sjlu"/>
<br />
_<b>sjlu</b>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/raphamorim">
<img src="https://avatars.githubusercontent.com/u/3630346?v=4" width="100;" alt="raphamorim"/>
<br />
_{<b>raphamorim</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/avreg">
<img src="https://avatars.githubusercontent.com/u/1052428?v=4" width="100;" alt="avreg"/>
<br />
_<b>avreg</b>
</a>
</td>
<td align="center">
<a href="https://github.com/alvynmcq">
<img src="https://avatars.githubusercontent.com/u/1619808?v=4" width="100;" alt="alvynmcq"/>
<br />
_{<b>alvynmcq</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/argoilves">
<img src="https://avatars.githubusercontent.com/u/7804734?v=4" width="100;" alt="argoilves"/>
<br />
_{<b>argoilves</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/svanscho">
<img src="https://avatars.githubusercontent.com/u/7288358?v=4" width="100;" alt="svanscho"/>
<br />
_{<b>svanscho</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/leonardocardoso">
<img src="https://avatars.githubusercontent.com/u/1775157?v=4" width="100;" alt="leonardocardoso"/>
<br />
_{<b>leonardocardoso</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/me-vlad">
<img src="https://avatars.githubusercontent.com/u/222185?v=4" width="100;" alt="me-vlad"/>
<br />
_{<b>me-vlad</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/wahajdar">
<img src="https://avatars.githubusercontent.com/u/25760541?v=4" width="100;" alt="wahajdar"/>
<br />
_{<b>wahajdar</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/leticiafernandes">
<img src="https://avatars.githubusercontent.com/u/13765802?v=4" width="100;" alt="leticiafernandes"/>
<br />
_{<b>leticiafernandes</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/lucasrodcosta">
<img src="https://avatars.githubusercontent.com/u/2574399?v=4" width="100;" alt="lucasrodcosta"/>
<br />
_{<b>lucasrodcosta</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/RussCoder">
<img src="https://avatars.githubusercontent.com/u/18438165?v=4" width="100;" alt="RussCoder"/>
<br />
_{<b>RussCoder</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/paulocesarjr">
<img src="https://avatars.githubusercontent.com/u/13860683?v=4" width="100;" alt="paulocesarjr"/>
<br />
_{<b>paulocesarjr</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/luzeduardo">
<img src="https://avatars.githubusercontent.com/u/770092?v=4" width="100;" alt="luzeduardo"/>
<br />
_{<b>luzeduardo</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/otmjka">
<img src="https://avatars.githubusercontent.com/u/5286446?v=4" width="100;" alt="otmjka"/>
<br />
_{<b>otmjka</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/hexray-newbee">
<img src="https://avatars.githubusercontent.com/u/15082228?v=4" width="100;" alt="hexray-newbee"/>
<br />
_{<b>hexray-newbee</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/derrod">
<img src="https://avatars.githubusercontent.com/u/3123295?v=4" width="100;" alt="derrod"/>
<br />
_{<b>derrod</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/gitter-badger">
<img src="https://avatars.githubusercontent.com/u/8518239?v=4" width="100;" alt="gitter-badger"/>
<br />
_{<b>gitter-badger</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/seanhussey">
<img src="https://avatars.githubusercontent.com/u/10438?v=4" width="100;" alt="seanhussey"/>
<br />
_{<b>seanhussey</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/rolandstarke">
<img src="https://avatars.githubusercontent.com/u/5196813?v=4" width="100;" alt="rolandstarke"/>
<br />
_{<b>rolandstarke</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/rcmachado">
<img src="https://avatars.githubusercontent.com/u/141832?v=4" width="100;" alt="rcmachado"/>
<br />
_{<b>rcmachado</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Niko78">
<img src="https://avatars.githubusercontent.com/u/17108017?v=4" width="100;" alt="Niko78"/>
<br />
_{<b>Niko78</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/MartinKolarik">
<img src="https://avatars.githubusercontent.com/u/6192491?v=4" width="100;" alt="MartinKolarik"/>
<br />
_{<b>MartinKolarik</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/MTRNord">
<img src="https://avatars.githubusercontent.com/u/1374914?v=4" width="100;" alt="MTRNord"/>
<br />
_{<b>MTRNord</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/jussike">
<img src="https://avatars.githubusercontent.com/u/7323729?v=4" width="100;" alt="jussike"/>
<br />
_{<b>jussike</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/kad3nce">
<img src="https://avatars.githubusercontent.com/u/556?v=4" width="100;" alt="kad3nce"/>
<br />
_{<b>kad3nce</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/jlmcdonald">
<img src="https://avatars.githubusercontent.com/u/3506893?v=4" width="100;" alt="jlmcdonald"/>
<br />
_{<b>jlmcdonald</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/revolter">
<img src="https://avatars.githubusercontent.com/u/5748627?v=4" width="100;" alt="revolter"/>
<br />
_{<b>revolter</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/gbarrostv">
<img src="https://avatars.githubusercontent.com/u/88685638?v=4" width="100;" alt="gbarrostv"/>
<br />
_{<b>gbarrostv</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/emilepommier">
<img src="https://avatars.githubusercontent.com/u/36151637?v=4" width="100;" alt="emilepommier"/>
<br />
_{<b>emilepommier</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/3dd13">
<img src="https://avatars.githubusercontent.com/u/223555?v=4" width="100;" alt="3dd13"/>
<br />
_<b>3dd13</b>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/bent0b0x">
<img src="https://avatars.githubusercontent.com/u/7697924?v=4" width="100;" alt="bent0b0x"/>
<br />
_{<b>bent0b0x</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/wijloc">
<img src="https://avatars.githubusercontent.com/u/16838209?v=4" width="100;" alt="wijloc"/>
<br />
_{<b>wijloc</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/mainadapter">
<img src="https://avatars.githubusercontent.com/u/30200769?v=4" width="100;" alt="mainadapter"/>
<br />
_{<b>mainadapter</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/lucasbraganca-tw">
<img src="https://avatars.githubusercontent.com/u/77497129?v=4" width="100;" alt="lucasbraganca-tw"/>
<br />
_{<b>lucasbraganca-tw</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/liamsegura">
<img src="https://avatars.githubusercontent.com/u/102547056?v=4" width="100;" alt="liamsegura"/>
<br />
_{<b>liamsegura</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/shaharmor">
<img src="https://avatars.githubusercontent.com/u/10861920?v=4" width="100;" alt="shaharmor"/>
<br />
_{<b>shaharmor</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/PNixx">
<img src="https://avatars.githubusercontent.com/u/1117351?v=4" width="100;" alt="PNixx"/>
<br />
_<b>PNixx</b>
</a>
</td>
<td align="center">
<a href="https://github.com/kolpax">
<img src="https://avatars.githubusercontent.com/u/3372392?v=4" width="100;" alt="kolpax"/>
<br />
_{<b>kolpax</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/arielfurtado">
<img src="https://avatars.githubusercontent.com/u/7703845?v=4" width="100;" alt="arielfurtado"/>
<br />
_{<b>arielfurtado</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/chooh">
<img src="https://avatars.githubusercontent.com/u/9463?v=4" width="100;" alt="chooh"/>
<br />
_<b>chooh</b>
</a>
</td>
<td align="center">
<a href="https://github.com/ogunkarakus">
<img src="https://avatars.githubusercontent.com/u/14255843?v=4" width="100;" alt="ogunkarakus"/>
<br />
_{<b>ogunkarakus</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/nicolaswalcker">
<img src="https://avatars.githubusercontent.com/u/50677753?v=4" width="100;" alt="nicolaswalcker"/>
<br />
_{<b>nicolaswalcker</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/ahmadmayahi">
<img src="https://avatars.githubusercontent.com/u/1689910?v=4" width="100;" alt="ahmadmayahi"/>
<br />
_{<b>ahmadmayahi</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/celiolatorraca">
<img src="https://avatars.githubusercontent.com/u/43214?v=4" width="100;" alt="celiolatorraca"/>
<br />
_{<b>celiolatorraca</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/chriswiggins">
<img src="https://avatars.githubusercontent.com/u/2830609?v=4" width="100;" alt="chriswiggins"/>
<br />
_{<b>chriswiggins</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/diegosperes">
<img src="https://avatars.githubusercontent.com/u/2347485?v=4" width="100;" alt="diegosperes"/>
<br />
_{<b>diegosperes</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/skrater">
<img src="https://avatars.githubusercontent.com/u/3642917?v=4" width="100;" alt="skrater"/>
<br />
_{<b>skrater</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/medeeiros">
<img src="https://avatars.githubusercontent.com/u/331136?v=4" width="100;" alt="medeeiros"/>
<br />
_{<b>medeeiros</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/jfairley">
<img src="https://avatars.githubusercontent.com/u/992483?v=4" width="100;" alt="jfairley"/>
<br />
_{<b>jfairley</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/markx">
<img src="https://avatars.githubusercontent.com/u/1816385?v=4" width="100;" alt="markx"/>
<br />
_<b>markx</b>
</a>
</td>
<td align="center">
<a href="https://github.com/KingHorse2015">
<img src="https://avatars.githubusercontent.com/u/15171668?v=4" width="100;" alt="KingHorse2015"/>
<br />
_{<b>KingHorse2015</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/moni33">
<img src="https://avatars.githubusercontent.com/u/90513592?v=4" width="100;" alt="moni33"/>
<br />
_{<b>moni33</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/LiShiSangZi">
<img src="https://avatars.githubusercontent.com/u/387171?v=4" width="100;" alt="LiShiSangZi"/>
<br />
_{<b>LiShiSangZi</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/CommanderRoot">
<img src="https://avatars.githubusercontent.com/u/4395417?v=4" width="100;" alt="CommanderRoot"/>
<br />
_{<b>CommanderRoot</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/timgates42">
<img src="https://avatars.githubusercontent.com/u/47873678?v=4" width="100;" alt="timgates42"/>
<br />
_{<b>timgates42</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/rpadovani">
<img src="https://avatars.githubusercontent.com/u/1713343?v=4" width="100;" alt="rpadovani"/>
<br />
_{<b>rpadovani</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Rakesh9100">
<img src="https://avatars.githubusercontent.com/u/73993775?v=4" width="100;" alt="Rakesh9100"/>
<br />
_{<b>Rakesh9100</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/nemesisqp">
<img src="https://avatars.githubusercontent.com/u/1621069?v=4" width="100;" alt="nemesisqp"/>
<br />
_{<b>nemesisqp</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Bugadinho">
<img src="https://avatars.githubusercontent.com/u/31747009?v=4" width="100;" alt="Bugadinho"/>
<br />
_{<b>Bugadinho</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Lucbm99">
<img src="https://avatars.githubusercontent.com/u/45500959?v=4" width="100;" alt="Lucbm99"/>
<br />
_{<b>Lucbm99</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/hugocm99">
<img src="https://avatars.githubusercontent.com/u/33068028?v=4" width="100;" alt="hugocm99"/>
<br />
_{<b>hugocm99</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/giselylucas-tw">
<img src="https://avatars.githubusercontent.com/u/81307139?v=4" width="100;" alt="giselylucas-tw"/>
<br />
_{<b>giselylucas-tw</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/fabiohcnobre">
<img src="https://avatars.githubusercontent.com/u/22354660?v=4" width="100;" alt="fabiohcnobre"/>
<br />
_{<b>fabiohcnobre</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Snoopynha">
<img src="https://avatars.githubusercontent.com/u/105990818?v=4" width="100;" alt="Snoopynha"/>
<br />
_{<b>Snoopynha</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Bubblesphere">
<img src="https://avatars.githubusercontent.com/u/8861575?v=4" width="100;" alt="Bubblesphere"/>
<br />
_{<b>Bubblesphere</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/brinobruno">
<img src="https://avatars.githubusercontent.com/u/81701584?v=4" width="100;" alt="brinobruno"/>
<br />
_{<b>brinobruno</b>}
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/brunacm-dev">
<img src="https://avatars.githubusercontent.com/u/71555436?v=4" width="100;" alt="brunacm-dev"/>
<br />
_{<b>brunacm-dev</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/poshe">
<img src="https://avatars.githubusercontent.com/u/4026615?v=4" width="100;" alt="poshe"/>
<br />
_<b>poshe</b>
</a>
</td>
<td align="center">
<a href="https://github.com/Ronkiro">
<img src="https://avatars.githubusercontent.com/u/27526023?v=4" width="100;" alt="Ronkiro"/>
<br />
_{<b>Ronkiro</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/Abubakrce19">
<img src="https://avatars.githubusercontent.com/u/104122959?v=4" width="100;" alt="Abubakrce19"/>
<br />
_{<b>Abubakrce19</b>}
</a>
</td>
<td align="center">
<a href="https://github.com/ahu">
<img src="https://avatars.githubusercontent.com/u/330336?v=4" width="100;" alt="ahu"/>
<br />
_<b>ahu</b>
</a>
</td>
</tr>
<tbody>
</table>

See the full list on our contributors page.

Security Copy Chapter

Found a vulnerability? Please do not open a public issue — see our Security Policy for how to report it privately and what falls in scope.

License Copy Chapter

BSD-3-Clause © Globo.com

---

SECURITY Copy Section

Security Policy

Supported Versions Copy Chapter

Clappr packages are versioned independently. Security fixes ship in the latest
published minor of each package (@clappr/player, @clappr/core,
@clappr/plugins, the playback packages, @clappr/telemetry, @clappr/zepto).
Older releases are not backported — the recommended remediation is to upgrade.

Reporting a Vulnerability Copy Chapter

Please do not open a public issue, pull request, or discussion for security
reports. Public reports expose users who have not yet had a chance to upgrade.
Report privately through GitHub Security Advisories:

Report a vulnerability

Include the affected package and version, the impact, and steps to reproduce —
a minimal HTML page or CodeSandbox is ideal.

Clappr is maintained by volunteers. We aim to acknowledge reports within a week
and will keep you posted in the advisory thread, including if we conclude the
report is not a vulnerability. We ask for up to 90 days before public
disclosure; when a fix ships we publish a GitHub Security Advisory and credit
you as the reporter unless you prefer otherwise.

Scope Copy Chapter

Clappr is a client-side media player library. It runs in the browser, inside the
page of whoever embeds it, and has no server component of its own.

In scope: XSS or script injection reachable through player options, media
metadata, or subtitle and caption tracks; prototype pollution in @clappr/core
or @clappr/zepto; bypass of same-origin or CORS expectations caused by
player code.

Out of scope:

- Content protection and DRM. Clappr is a library, not a content manager. It
does not hold keys, issue or validate licenses, or enforce playback rights —
those belong to the platform CDM, the device, and the license server operated
by whoever embeds the player. Report those to the CDM vendor or to the service
distributing the content.
- Upstream dependencies. Report to hls.js
or shaka-player directly. Tell
us anyway if Clappr's usage makes the impact worse.
- Issues that require the embedder to pass attacker-controlled HTML into a
documented HTML-accepting option.
- Missing security headers, TLS configuration, or other infrastructure findings
on clappr.io and the documentation site.
- Automated scanner output without a demonstrated impact.

---