BBB HTML5 custom clients

Wie startet man HTML5 custom code?

fairblue is the BBB variant of the HTML5 client by fairkom with features like

Audio-Share
Translation

audioshare client bauen und installieren

git pull https://git.fairkom.net/chat/fairblue/meet.git

git checkout translation-2.2.31

cd fairblue/bigbluebutton-html5

curl https://install.meteor.com/ | sh

meteor update --allow-superuser --release 1.8

backup settings.yml

mkdir ~/backup

cp /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml ~/backup/settings.yml

adjust wsUrl in settings.yml

grep "wsUrl" /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml

vi private/config/settings.yml

sudo systemctl stop bbb-html5

meteor npm install

mkdir ~/bbb-install

METEOR_ALLOW_SUPERUSER=1 meteor build --server-only ~/bbb-install

cd ~/bbb-install

sudo tar -xzvf *.tar.gz -C /usr/share/meteor

wird das Packet ausgetauscht und kann dann mit systemctl restart bbb-html5 neu gestartet werden. Mit bbb-conf --restart sollte es keine Probleme mehr geben.

Achtung: Alter HTML5 Client ist dann nicht mehr verfügbar! (müsste dann aus dem repo wieder neu gebaut werden)

development

Zuerst überprüfen ob der html5-client läuft mit

bbb-conf --status

Client wird beenden mit

systemctl stop bbb-html5

Der neue Client liegt im Verzeichnis bigbluebutton-html5 und wird in einer eigenen parallelen Session gestartet.

cd bigbluebutton-html5
screen #enter drücken beim Startbild von screen
METEOR_ALLOW_SUPERUSER=1 npm start

Strg a+d zum Verlassen des attached screens ohne die Screensession zu beenden

Erklärung in der BBB-Dokumentation

Ich empfehle nur einen Unterschied, vorher mit 'screen' eine screen Session zu öffnen und mit 'METEOR_ALLOW_SUPERUSER=1 npm start' zu starten.

Wie schaltet man den test code ab?

Der Code für das Audiosharing läuft in einer screen session. Es sollte nur eine laufen, also mit screen -r auf die Session verbinden und den laufenden Prozess mit strg+c beenden. Mit Strg a+d den Screen verlasen. Daraufhin mit systemctl start bbb-html5 die Standardversion wieder hochfahren.

Restart von BBB

Durch den Code des Audiosharings kann es dazu kommen, dass bei einem Neustart mehrere Meteorsessions auf den selben Port wollen, weil beide html5 clients eingeschalten sind. Deshalb zuerst den Code beenden und nach dem Neustart wieder starten, außerdem wieder darauf achten, ob der native client eingeschalten ist oder eben wieder den Code starten.

HTML5 Client with draw.io and wekan

install custom HTML5 client

   git clone https://github.com/danijel1310/bigbluebutton/tree/int-drawio-wekan2/bigbluebutton-html5

set in private/config/settings.yml the parameter "sipjsHackViaWs" to true

systemctl stop bbb-html5
su impl
cd ~/dev/bigbluebutton/bigbluebutton-html5
npm start

start more applications on + button

available on test server pfaender.fairteaching.net