Go to file
sualko 66cbd8344d docs: add admin screenshot 2021-02-13 19:20:26 +01:00
.github docs: add admin screenshot 2021-02-13 19:20:26 +01:00
.tx chore: prepare translation 2020-05-16 14:44:21 +02:00
appinfo feat: bump Nextcloud dependency 2021-02-13 18:30:58 +01:00
docs docs: add admin screenshot 2021-02-13 19:20:26 +01:00
img fix: Add missing image to repository 2020-12-22 08:51:22 +01:00
l10n [tx-robot] updated from transifex 2021-02-11 03:35:54 +00:00
lib fix: psalm errors 2021-02-13 18:30:59 +01:00
scripts chore: fix build scripts 2021-02-01 10:57:41 +01:00
templates fix: translate settings header 2021-02-13 16:46:31 +01:00
tests fix: psalm errors 2021-02-13 18:30:59 +01:00
ts chore: add link to contributor guide 2021-02-13 16:46:31 +01:00
.eslintrc.js refactor: enforce semicolons in ts 2020-04-27 16:50:45 +02:00
.gitattributes chore: add gitattributes 2021-01-23 11:34:00 +01:00
.gitignore chore: ignore vsc settings 2021-01-31 18:42:15 +01:00
.php_cs.dist refactor: order imports 2020-09-23 12:33:09 +02:00
.stylelintrc.json chore: fix linting 2020-04-26 22:41:06 +02:00
CHANGELOG.md docs: update change log 2021-02-01 11:00:00 +01:00
CODE_OF_CONDUCT.md docs: add code of conduct 2020-05-17 11:54:22 +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: add admin screenshot 2021-02-13 19:20:26 +01:00
babel.config.js Initial commit 2020-04-26 11:36:41 +02:00
commitlint.config.js chore: ignore tx-robot commits if linting 2020-06-04 10:06:57 +02:00
composer.json ci: fix workaround for php 7.2 2021-02-13 18:30:59 +01:00
composer.lock ci: fix workaround for php 7.2 2021-02-13 18:30:59 +01: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: 1.2.0 🎉 2021-02-01 11:10:17 +01:00
phpunit.integration.xml test: add integration test for room mapper 2020-06-18 15:07:19 +02:00
phpunit.xml ci: fix workaround for php 7.2 2021-02-13 18:30:59 +01:00
psalm.xml fix: psalm errors 2021-02-13 18:30:59 +01:00
tsconfig.json Initial commit 2020-04-26 11:36:41 +02:00
webpack.common.js feat: add option to require moderator 2020-08-29 14:37:50 +02:00
webpack.dev.js chore: update js dependencies 2020-09-01 09:59:23 +02:00
webpack.prod.js chore: update js dependencies 2020-09-01 09:59:23 +02:00
yarn.lock chore: refactor build and publish script 2021-01-31 18:42:15 +01:00

README.md

BigBlueButton™ integration for Nextcloud

Static analysis PHP Tests Lint Downloads GitHub release

ko-fi

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
  • Share rooms Share rooms with members, groups or circles
  • Custom presentation Start a room with a selected presentation from your file browser
  • Manage recordings View, share and delete recordings for your rooms
  • Restrictions Restrict room creation to certain groups
  • Activities Get an overview of your room activities

🚀 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.

Screenshot admin section

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 the room doesn't appear in the ... menu of files, a browser/cache reload might help

❤️ 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 🎉.