Bigbluebutton recordings export to webm or mp4 & live broadcasting. This is an example how I have implemented BBB recordings to distibutable file.
- Videos will be copy to
/var/www/bigbluebutton-default/record. You can change value ofcopyToPathfrom.env. - Can be converted to
mp4. Defaultwebm - Specify bitrate to control quality of the exported video by adjusting
videoBitsPerSecondproperty inbackground.js
- xvfb (
apt install xvfb) - Google Chrome stable
- npm modules listed in package.json
- Everything inside
dependencies_check.sh(run./dependencies_check.shto install all)
The latest Google Chrome stable build should be use.
curl -sS -o - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list
apt-get -y update
apt-get -y install google-chrome-stableFFmpeg (if not installed already & have plan for mp4 or RTMP)
sudo add-apt-repository ppa:jonathonf/ffmpeg-4
sudo apt-get update
sudo apt-get install ffmpegClone the project first:
git clone https://github.com/jibon57/bbb-recorder
cd bbb-recorder
npm install --ignore-scripts
cp .env.example .envBuild the container once.
git clone https://github.com/jibon57/bbb-recorder
cd bbb-recorder
docker build -t bbb-recorder .Then prefix the docker run command before the following examples.
docker run --detach -v ~/local-output-dir:/output bbb-recorderIn this case we specify --detach which means the container will run in background until it finishes.
For the recording export example this would be:
docker run --detach -v ~/local-output-dir:/output bbb-recorder node export.js "https://BBB_HOST/playback/presentation/2.0/playback.html?meetingId=MEETING_ID" meeting.webm 10 trueYou can simplify this task with an alias:
alias bbb='docker run --detach -v ~/local-output-dir:/output bbb-recorder node export.js'
bbb "https://BBB_HOST/playback/presentation/2.0/playback.html?meetingId=MEETING_ID" meeting.webm 10 truenode export.js "https://BBB_HOST/playback/presentation/2.0/playback.html?meetingId=MEETING_ID" meeting.webm 10 trueOptions
You can pass 4 args
- BBB recording link (mandatory)
- (Optional) Export file name (should be
.webmat end). You can use "MEETING_ID" (without.webm) to set the meeting ID as export name. Default: MEETING_ID - (Optional) Duration of recording (in seconds). You can set it to 0 use the real duration of recording. Default: real duration of recording
- (Optional) Convert to mp4 or not (true for convert to mp4). Default: false
You can also use liveJoin.js to live join meeting as a recorder & perform recording like this:
node liveJoin.js "https://BBB_HOST/bigbluebutton/api/join?meetingId=MEETING_ID...." liveRecord.webm 0 trueHere 0 mean no limit. Recording will auto stop after meeting end or kickout of recorder user. You can also set time limit like this:
node liveJoin.js "https://BBB_HOST/bigbluebutton/api/join?meetingId=MEETING_ID...." liveRecord.webm 60 trueSometime you may want to broadcast meeting via RTMP. To test you can use ffmpegServer.js to run websocket server & liveRTMP.js to join the meeting. You'll have to edit rtmpUrl & ffmpegServer info inside .env file (if need).
- First run websocket server by
node ffmpegServer.js - Then in another terminal tab
node liveRTMP.js "https://BBB_HOST/bigbluebutton/api/join?meetingId=MEETING_ID...."You can also set duration otherwise it will close after meeting end or kickout:
node liveRTMP.js "https://BBB_HOST/bigbluebutton/api/join?meetingId=MEETING_ID...." 20Check the process of websocket server, ffmpeg should start sending data to RTMP server.
Alternatively, you can stream via a docker container:
# copy compose file, update the environment params and the meeting join url
cp docker-compose.yml.livertmp-stream-example docker-compose.yml
docker-compose build
docker-compose upWhen you will run the command that time Chrome browser will be open in background & visit the link to perform screen recording. So, if you have set 10 seconds then it will record 10 seconds only. Later it will give you file as webm or mp4.
Note: It will use extra CPU to process chrome & ffmpeg.
We are offering cheaper Bigbluebutton Premium hosting or Bigbluebutton installation/configuration/loadbalance service. You can send me email jibon[@]mynaparrot.com
puppetcam. Most of the parts were copied from there.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent