Go to file
sualko e1da5ebffc chore: prepare translation
fix #2
2020-05-16 14:44:21 +02:00
.github/ISSUE_TEMPLATE docs: update issue templates 2020-05-02 20:57:54 +02:00
.tx chore: prepare translation 2020-05-16 14:44:21 +02:00
appinfo release: 0.1.2 🎉 2020-04-29 13:30:30 +02:00
docs docs: update readme 2020-04-29 12:12:15 +02:00
img Initial commit 2020-04-26 11:36:41 +02:00
l10n chore: prepare translation 2020-05-16 14:44:21 +02:00
lib fix: allow start/stop recording 2020-04-29 13:14:42 +02:00
scripts build: use same code style for scripts 2020-04-29 14:16:57 +02:00
templates chore: prepare translation 2020-05-16 14:44:21 +02:00
ts chore: prepare translation 2020-05-16 14:44:21 +02:00
.commitlintrc.json build: enhance publish script 2020-04-28 14:16:19 +02:00
.eslintrc.js refactor: enforce semicolons in ts 2020-04-27 16:50:45 +02:00
.gitignore chore: add build scripts 2020-04-28 01:19:34 +02:00
.php_cs.dist ci: add travis 2020-04-29 11:47:51 +02:00
.stylelintrc.json chore: fix linting 2020-04-26 22:41:06 +02:00
.travis.yml ci: add travis 2020-04-29 11:47:51 +02:00
CHANGELOG.md docs: update change log 2020-04-29 13:30:20 +02:00
COPYING Initial commit 2020-04-26 11:36:41 +02:00
Makefile make app id shorter 2020-04-26 13:26:34 +02:00
README.md docs: update readme 2020-04-30 09:54:25 +02:00
babel.config.js Initial commit 2020-04-26 11:36:41 +02:00
composer.json fix: api request failed 2020-04-27 16:36:14 +02:00
composer.lock fix: api request failed 2020-04-27 16:36:14 +02:00
composer.phar use fork of bbb api 2020-04-26 12:13:04 +02:00
declarations.d.ts Initial commit 2020-04-26 11:36:41 +02:00
package.json release: 0.1.2 🎉 2020-04-29 13:30:30 +02:00
tsconfig.json Initial commit 2020-04-26 11:36:41 +02:00
webpack.common.js Initial commit 2020-04-26 11:36:41 +02:00
webpack.dev.js Initial commit 2020-04-26 11:36:41 +02:00
webpack.prod.js Initial commit 2020-04-26 11:36:41 +02:00
yarn.lock build: enhance publish script 2020-04-28 14:16:19 +02:00

README.md

BigBlueButton™ integration for Nextcloud

Build Status Downloads GitHub release

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

👏 Developer wanted! 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

😍 Features

This integration provides the following features:

  • Room setup Create multiple room configurations with name, welcome message, ...
  • Share guest link Share the room link with all your guests
  • Custom presentation Start a room with a selected presentation from your file browser

🚀 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/sualko/cloud_bbb.git bbb

Then install the dependencies using:

make build

⚙️ 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.

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.

Enter a room from files

Use the ... menu and select the desired BBB configuration to enter the room. Beware that if the room is already running the presentation will not be updated. Entering a room with a defined presentation works only if link shares are enabled and do not require authentication. See #1 for details.

Screenshot file browser

Notes

  • By using the Link Editor you can share rooms as any other file

Troubleshooting

  • Before installing, make sure your BBB is running correctly
  • If no session opens with the ... menu of files, but a session opens in the general configuration page, look at your browser console. It will show a well hidden complaint that for sharing always a password is required. If this is the case, remove that requirement in sharing / enforce password.
  • If the room doesn't appear in the ... menu of files, a browser/cache reload might help