search

littleredbutton / cloud_bbb

@bigbluebutton integration for @nextcloud
GNU Affero General Public License v3.0
103 stars 42 forks source link
collaboration conference integration video webrtc

readme

BigBlueButton™ integration for Nextcloud

Static analysis PHP Tests Lint Downloads GitHub release

This app allows to create meetings with an external installation of BigBlueButton.

:clap: Contributors are welcome! If you have time it would be awesome if you could help to enhance this application.

This app uses BigBlueButton and is not endorsed or certified by BigBlueButton Inc. BigBlueButton and the BigBlueButton Logo are trademarks of BigBlueButton Inc.

Screenshot configuration

:heart_eyes: Features

This integration provides the following features:

:rocket: Install it

The easiest way to install this app is by using the Nextcloud app store. If you like to build from source, please continue reading.

To install it change into your Nextcloud's apps directory:

cd nextcloud/apps

Then run:

git clone https://github.com/littleredbutton/cloud_bbb.git bbb

Then install the dependencies using:

make build

:gear: Configure it

Get your BBB API url and secret by executing sudo bbb-conf --secret on your BBB server.

$ sudo bbb-conf --secret

    URL: https://bbb.your.domain/bigbluebutton/
    Secret: abcdefghijklmnopqrstuvwxyz012345679

    Link to the API-Mate:
    https://mconf.github.io/api-mate/#server=https://...

Enter these values in the additional settings section on the admin configuration page of your Nextcloud instance.

Screenshot admin section

Manual configuration (for experts)

If you prefer not to use the web interface for configuration, you will find all used configuration keys in the list below. Please beware that there will be no check if those values are correct. Therefore this is not the recommended way. The syntax to set all settings is occ config:app:set bbb KEY --value "VALUE".

Key Description
app.navigation Set to true to show navigation entry
app.navigation.name Defines the navigation label. Default "BigBlueButton".
api.url URL to your BBB server. Should start with https://
api.secret Secret of your BBB server
api.meta_analytics-callback-url URL which gets called after meetings ends to generate statistics. See bbb-analytics.
app.shortener Value of your shortener service. Should start with https:// and contain {token}.
avatar.path Absolute path to an optional avatar cache directory.
avatar.url URL which serves avatar.path to be used as avatar cache.

Avatar cache (v2.2+)

The generation of avatars puts a high load on your Nextcloud instance, since the number of requests increases squarely to the number of participants in a room. To mitigate this situation, this app provides an optional avatar file cache. To activate the cache avatar.path and avatar.url have to be configured. avatar.path must provide an absolute path (e.g. /srv/bbb-avatar-cache/) to a directory which is writable by the PHP user. avatar.url must contain the url which serves all files from avatar.path. To bypass browser connection limits we recommend to setup a dedicated host.

Example Apache configuration for a dedicated host with avatar.path = /srv/bbb-avatar-cache/ and avatar.url = https://avatar-cache.your-nextcloud.com/:

<VirtualHost *:443>
        ServerName avatar-cache.your-nextcloud.com

        Header always set Strict-Transport-Security "max-age=15768000;"

        DocumentRoot /srv/bbb-avatar-cache
        <Directory /srv/bbb-avatar-cache>
                Options -FollowSymLinks -Indexes
        </Directory>

        SSLEngine On
        # SSL config...
</VirtualHost>

For additional security, we recommend to disable directory listing, symlinks and any language interpreter such as php for the cache directory.

Cached avatars are usually deleted as soon as the meeting ends. In cases the BBB server shuts down unexpected, we provide the bbb:clear-avatar-cache occ command (example use: ./occ bbb:clear-avatar-cache).

:bowtie: User guide

Create your first room

Go to the BigBlueButton section inside your personal settings page and enter a room name. That's it. You can now distribute the room url.

Share a room

Edit your room configuration and select groups or users you wish to share your room with. You can define the access level for your shared room (admin, moderator or simple user).

Screenshot sharing room

:notebook: Notes

:pick: Troubleshooting

:heart: Sponsors

Writing such an application is a lot of work and therefore we are specially thankful for people and organisations who are sponsoring features or bug fixes:

If you are looking for other ways to contribute to this project, you are welcome to look at our contributor guidelines. Every contribution is valuable :tada:.