createwebinar/bbb-download

Produce downloadable material from BigBlueButton recordings

bbb-download

The code will be maintained by createwebinar.com developer team

A python script that produces downloadable material for existing and new recordings for your BigBlueButton server. Final MP4 video will include only presentation, audio and screenshare (no chat window, no whiteboard).

• BigBlueButton 2.0 is supported (10.08.2018)
• Screenshare supported (18.09.2018)
• BigBlueButton 2.2 is supported (tested with BBB 2.2 beta 8)

Requirements

1. python2.7
2. ffmpeg compiled with libx264 support (included)
3. Installed and configured Big Blue Button server (1.1 or 2.0+)

Installation (need to be root)

git clone https://github.com/createwebinar/bbb-download.git
cd bbb-download
chmod u+x install.sh 
sudo ./install.sh
# To convert all of your current recordings to MP4 format use command:
sudo bbb-record --rebuildall

This copies the download scripts to the BigBlueButton scripts folder, and copies compiled FFMPEG to the /opt/ffmpeg folder. It also installs python2.7 and additional libs and give an appropriate rights for MP4 files to make them available for download.

NOTE: You may use the guide here to compile ffmpeg in Ubuntu by your own. Be sure to include the following flags.

--enable-version3 --enable-postproc --enable-libvorbis --enable-libvpx --enable-libx264 --enable-libmp3lame --enable-libfdk-aac --enable-gpl --enable-nonfree''

Usage

After running the installation script (install.sh), the python script that produces the downloadable material, will be called for each recording automatically by the BigBlueButton monitoring scripts, after each recording has been transcoded and published.

Outputs

Final MP4 video will include only presentation, audio and screenshare (no chat window, no whiteboard).

Link to download MP4 file will look like this: https://yourBBBserverURL/download/presentation/{meetingID}/{meetingID}.mp4 If your BigBlueButton server is connected to https://createwebinar.com contol panel, all webinar participants will be able to download the recorded webinars from the website in one click.

bbb-download's Issues

Not Working with ubuntu 18.04 that is running the latest BigBlueButton 2.3.0

Not Working with ubuntu 18.04 that is running the latest BigBlueButton 2.3.0
this what showing when installing
MyServer:/bbb-download# sudo ./install.sh
Reading package lists... Done
Building dependency tree
Reading state information... Done
python is already the newest version (2.7.15rc1-1).
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package libva-x11-1
E: Unable to locate package libva-drm1
E: Unable to locate package libfdk-aac-dev
chown: invalid user: ‘tomcat7:tomcat7’

Any update?

Webcam and annotations

Dear All, all of this module works well. But I couldn't see the webcam or any annotations in the output. How can we define them to be in the output ( for e.g. webcam goes in the bottom and left corner of the video and it will resized)

Newly generated video not working in vimeo

Hi,
I am using your code it's so helpful, Thanks for that...

BBB video conversion & publish is working fine. I am using vimeo to store this recording videos. Video working fine in the direct mp4 link which is generated in BBB server but If i upload the same video to vimeo it's not transcoding so it's not viewable.
Kindly guid me to resolve this issue.

Thanks in Advance!

mp4 not generated for some rebuilds

Hello

For new recordings of short duration the mp4 is created.

Did a Rebuild on an existing BBB recording and the mp4 was not generated.

Looked into /var/log/bigbluebutton/download/meetingid.log

Looked liked the log had what FFmpeg was trying to do when converting the recording and here is the error at the end of the log.

bbb_version: 2.1.0
Traceback (most recent call last):
File "/usr/local/bigbluebutton/core/scripts/post_publish/download.py", line 288, in
main()
File "/usr/local/bigbluebutton/core/scripts/post_publish/download.py", line 267, in main
dictionary, length, dims = prepare(bbb_version)
File "/usr/local/bigbluebutton/core/scripts/post_publish/download.py", line 183, in prepare
dictionary, length = extract_timings(bbb_version)
File "/usr/local/bigbluebutton/core/scripts/post_publish/download.py", line 57, in extract_timings
temp = float(out_times[len(out_times) - 1])
ValueError: could not convert string to float:

Would appreciate if you could point in the right direction.

add logo / watermarking in logo

Dear all, @createwebinar
I want to attach a logo in the video. How can I do that?

Nginx

Thank you for you script.
i wanted to run it on my selfhosted server but when i click download mp4 video it redirect me to home page ( im using greenlight as front end ) , is there any work around the nginx file ?

produce downloadable content

Where's the mp4 file is saved on the server?
I ran this script and records were generated in /download/presentation/{meeting_id}
But they are not downloadable.
so how to use this script?

Recordings not being published into the published directory !!

I have installed BBB on AWS EC2 on a c5.xlarge instance. After installing all the dependencies and I try to rebuild a recording this is the output I see.

Marking for rebuild 7d0962e86042f1c75b384ea0a82f1986c59d3386-1593583022137
removed '/var/bigbluebutton/recording/status/sanity/7d0962e86042f1c75b384ea0a82f1986c59d3386-1593583022137.done'
removed '/var/bigbluebutton/recording/status/sanity/7d0962e86042f1c75b384ea0a82f1986c59d3386-1593583022137.fail'

The rebuild process was successful for 4-5 recordings and after that they completely fail.

Can some one let me know what's going wrong

delete specific video with sessionID or recordID or meetingID

Dear @createwebinar , I want to call one function which delete specific video session with API. Could you help me for this moment?
I use laravel API https://github.com/joisarjignesh/bigbluebutton for deleting the playback but I couldn't find anything which try to call a function and delete specific recording with recordID or meetingID.