WebPlayer Documentation
WebPlayer turns every media link on your page into a playable track. It detects audio files, video files, YouTube links, playlist files, and more -- then presents them in a sleek, persistent player at the bottom of the page. No configuration required.
Getting started in 30 seconds
Add this line before your closing </body> tag:
<script src="https://webplayer.warmerdam.ai/widget/loader.js" async></script>
That is it. Every media link on your page is now playable.
Feature availability
The hosted widget provides full playback capabilities out of the box. Some advanced features that depend on external APIs are in preview and not yet available for external publisher embeds.
| Feature | External Publishers | Demo Site |
|---|---|---|
| Media link detection | Yes | Yes |
| YouTube / Vimeo playback | Yes | Yes |
| HTML5 audio & video | Yes | Yes |
| Playlist support (.xspf, .m3u, .pls) | Yes | Yes |
| Theming (dark / light / auto) | Yes | Yes |
| Play buttons on links | Yes | Yes |
| Term detection | Not yet | Yes |
| YouTube search (via term detection) | Not yet | Yes |
Interested in AI term detection? Let us know -- see Configuration for details.
Documentation sections
SetupGet WebPlayer running on your site in under a minute.ConfigurationCustomize behavior with WPParams, data attributes, and HTML classes.API ReferenceControl playback, volume, and playlist programmatically via JavaScript.FormatsSupported audio, video, playlist, and streaming formats.ExamplesCopy-paste code examples for common use cases.Self-HostingRun your own WebPlayer backend and use the npm packages directly.