mirror of https://github.com/sualko/cloud_bbb
docs: beautify readme
parent
8cbfcab7c4
commit
31e64d5519
56
README.md
56
README.md
|
@ -1,8 +1,28 @@
|
||||||
# BigBlueButton™ integration for Nextcloud
|
# BigBlueButton™ integration for Nextcloud
|
||||||
|
|
||||||
:arrow_right: __This app uses BigBlueButton and is not endorsed or certified by BigBlueButton Inc. BigBlueButton and the BigBlueButton Logo are trademarks of BigBlueButton Inc.__
|
[![Build Status](https://travis-ci.org/sualko/cloud_bbb.svg?branch=master)](https://travis-ci.org/sualko/cloud_bbb)
|
||||||
|
![Downloads](https://img.shields.io/github/downloads/sualko/cloud_bbb/total.svg)
|
||||||
|
![GitHub release](https://img.shields.io/github/release/sualko/cloud_bbb.svg)
|
||||||
|
|
||||||
|
This app allows to create meetings with an external installation of [BigBlueButton](https://bigbluebutton.org).
|
||||||
|
|
||||||
|
:clap: Developer wanted! If you have time it would be awesome if you could help to enhance this application.
|
||||||
|
|
||||||
|
![Screenshot configuration](https://github.com/sualko/cloud_bbb/raw/master/docs/screenshot-configuration.png)
|
||||||
|
|
||||||
|
__This app uses BigBlueButton and is not endorsed or certified by BigBlueButton Inc. BigBlueButton and the BigBlueButton Logo are trademarks of BigBlueButton Inc.__
|
||||||
|
|
||||||
|
## :heart_eyes: 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
|
||||||
|
|
||||||
|
## :rocket: Install it
|
||||||
|
The easiest way to install this app is by using the [Nextcloud app store](https://apps.nextcloud.com/apps/bbb).
|
||||||
|
If you like to build from source, please continue reading.
|
||||||
|
|
||||||
## Install it
|
|
||||||
To install it change into your Nextcloud's apps directory:
|
To install it change into your Nextcloud's apps directory:
|
||||||
|
|
||||||
cd nextcloud/apps
|
cd nextcloud/apps
|
||||||
|
@ -14,29 +34,29 @@ Then run:
|
||||||
Then install the dependencies using:
|
Then install the dependencies using:
|
||||||
|
|
||||||
make build
|
make build
|
||||||
|
|
||||||
|
|
||||||
## configure it
|
|
||||||
|
## :gear: Configure it
|
||||||
find out your BBB secrets by '''sudo bbb-conf --secret'''
|
find out your BBB secrets by '''sudo bbb-conf --secret'''
|
||||||
|
|
||||||
enter these secrets in the BigBlueButton settings on the general configuration page of your NC
|
enter these secrets in the BigBlueButton settings on the general configuration page of your NC
|
||||||
|
|
||||||
## create your first room
|
## Create your first room
|
||||||
go to your personal settings page
|
Got to the BigBlueButton section inside your personal settings page and enter a
|
||||||
|
room name. That's it. You can now distribute the room url.
|
||||||
|
|
||||||
find the BigBlueButton section
|
## 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.
|
||||||
|
|
||||||
enter a room name
|
![Screenshot file browser](https://github.com/sualko/cloud_bbb/raw/master/docs/screenshot-file-browser.png)
|
||||||
|
|
||||||
enter the room by pointing to the arrow button
|
|
||||||
|
|
||||||
## enter a room from files
|
|
||||||
|
|
||||||
use the ... menu
|
|
||||||
|
|
||||||
select the correct BBB room and enter the room
|
|
||||||
|
|
||||||
# Troubleshooting
|
# Troubleshooting
|
||||||
- before installing, make sure your BBB is running correctly
|
- 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 no session opens with the ... menu of files, but a session opens in the
|
||||||
- if the room doesn't appear in the ... menu of files, a browser/cache reload might help
|
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
|
||||||
|
|
Loading…
Reference in New Issue