This plugin is one of the official bbb plugins. It basically decreases the external video's volume when a user is speaking in the meeting.

1. Start the development server:

cd $HOME/src/plugin-decrease-volume-on-speak
npm install
npm start

2. Add reference to it on BigBlueButton's settings.yml:

  plugins:
    - name: DecreaseVolumeOnSpeak
      url: http://127.0.0.1:4701/static/DecreaseVolumeOnSpeak.js

To build the plugin for production use, follow these steps:

cd $HOME/src/plugin-decrease-volume-on-speak
npm ci
npm run build-bundle

The above command will generate the dist folder, containing the bundled JavaScript file named DecreaseVolumeOnSpeak.js. This file can be hosted on any HTTPS server.

To use the plugin with BigBlueButton, add the plugin's URL to settings.yml as shown below:

public:
  app:
    ... // All app configurations
  plugins:
    - name: DecreaseVolumeOnSpeak
      url: <<PLUGIN_URL>>
  ... // All other configurations

Alternatively, you can host the bundled file on the BigBlueButton server by copying dist/DecreaseVolumeOnSpeak.js to the folder /var/www/bigbluebutton-default/assets/plugins. In this case, the <<PLUGIN_URL>> will be https://<your-host>/plugins/DecreaseVolumeOnSpeak.js.