You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Nextcloud bot 44ca9c0c8f
[tx-robot] updated from transifex
4 hours ago
.github ci: downgrade api package 3 months ago
.tx chore: prepare translation 1 year ago
appinfo release: 2.0.0 🎉 3 months ago
docs docs: add admin screenshot 8 months ago
img fix: Add missing image to repository 10 months ago
l10n [tx-robot] updated from transifex 4 hours ago
lib fix: log response message 3 months ago
scripts chore: fix build script 6 months ago
templates feat: add option to use theme in bbb 6 months ago
tests chore: update psalm baseline 3 months ago
ts fix(ui): sort recordings by date 3 months ago
.eslintrc.js refactor: enforce semicolons in ts 2 years ago
.gitattributes chore: add gitattributes 9 months ago
.gitignore chore: ignore vsc settings 9 months ago
.php_cs.dist refactor: order imports 1 year ago
.stylelintrc.json chore: fix linting 2 years ago
CHANGELOG.md docs: update change log 3 months ago
CODE_OF_CONDUCT.md docs: add code of conduct 1 year ago
COPYING Initial commit 2 years ago
Makefile make app id shorter 2 years ago
README.md docs: fix formatting 5 months ago
babel.config.js Initial commit 2 years ago
commitlint.config.js chore: ignore tx-robot commits if linting 1 year ago
composer.json chore: update nc api 3 months ago
composer.lock chore: update nc api 3 months ago
declarations.d.ts Initial commit 2 years ago
package.json release: 2.0.0 🎉 3 months ago
phpunit.integration.xml test: add integration test for room mapper 1 year ago
phpunit.xml ci: fix workaround for php 7.2 8 months ago
psalm.xml fix: psalm errors 8 months ago
tsconfig.json Initial commit 2 years ago
webpack.common.js feat: add option to require moderator 1 year ago
webpack.dev.js chore: update js dependencies 1 year ago
webpack.prod.js chore: update js dependencies 1 year ago
yarn.lock chore: update dependencies 4 months ago

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

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
app.shortener Value of your shortener service. Should start with https:// and contain {token}.

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

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
  • To share an audio (mp3) or video (mp4) file with your audience follow these steps (more info in #148):
    • create a public share of the exact file
    • copy the location of the share from the share information screen into your clipboard
    • open big blue button, press the plus icon in the lower left corner
    • click on add external video
    • paste the url from your clipboard and append the following string for audio /download?.mp3 or /download?.mp4 for video files
  • To connect to a ScaleLite server, use the url like https://yourscalelite.url/bigbluebutton/ without additional api/ and as secret ScaleLite's LOADBALANCER_SECRET

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