rename page to BBB HTML5 custom clients authored by Roland Alton's avatar Roland Alton
# 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](https://docs.bigbluebutton.org/2.2/dev.html#developing-the-html5-client)
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
```
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
\ No newline at end of file