A robust, dependency-free audio player for noVNC, supporting MediaMTX/HLS.
npm install novnc-audio-pluginA robust, dependency-free audio player for noVNC.
This package provides a simple way to add audio playback to your noVNC setup, using HLS streams from a media server like MediaMTX.
> Warning: Cross-Origin (CORS) Policy
> Modern web browsers will block audio from a different domain than the noVNC page is served from. To play a stream from a different server (i.e., a public radio station or a local server on a different port), you must use a reverse proxy (like Nginx) to make the stream appear to come from the same origin as the noVNC page. The proxy must also be configured to handle CORS headers correctly.
You can use this package directly from a CDN like jsDelivr, without needing to install it. This is the easiest and recommended method.
Simply add the following script tag to your HTML file, before the closing tag:
``html`
You can specify a custom HLS stream path using the data-stream-path attribute in the script tag.
`html`
By default, the plugin will try to connect to the HLS stream at /stream/index.m3u8.
To play standard Icecast streams, use the novnc-icecast-audio.js script. You must provide a full URL to your stream in the data-stream-path attribute.
`html`
> Note: If the audio button does not appear in the noVNC control bar, please try a hard refresh of your browser (Ctrl+Shift+R or Cmd+Shift+R).
If you prefer not to use the CDN, you can download the scripts from a specific release and host them yourself. This is the recommended way to ensure you are using a stable version.
1. Download the script for your streaming server:
2. Place the downloaded file in your noVNC installation directory.
3. Add the appropriate script tag to your HTML file:
`html
`
If you are bundling this plugin into a larger project, you can install it via npm:
`bash`
npm install novnc-audio-plugin
Then you can include it in your project as needed:
`html``
You can find the source code for this package on GitHub:
https://github.com/nagamuslim/novnc-audio-plugin
This package is also available on the npm registry: