Big Blue Button (BBB) Downloader

Downloads a BBB lesson as MP4 video, including presentation, audio, webcam and screenshare.

Nevertheless, I would definitely recommend you to record a BBB meeting with OBS, it's more efficient and you have more control over the outcome.

Setup

1. Install Python >=3.7
2. Install ffmpeg
3. Run: pip install bbb-dl as administrator

Usage

usage: bbb-dl [-h] [-aw] [-aa] [-kt] [-v] [-ncc] [--version] [--encoder ENCODER] [--audiocodec AUDIOCODEC] [-f FILENAME] URL

Big Blue Button Downloader that downloads a BBB lesson as MP4 video

positional arguments:
  URL                   URL of a BBB lesson

optional arguments:
  -h, --help            show this help message and exit
  -aw, --add-webcam     add the webcam video as an overlay to the final video
  -aa, --add-annotations
                        add the annotations of the professor to the final video
  -kt, --keep-tmp-files
                        keep the temporary files after finish
  -v, --verbose         print more verbose debug informations
  -ncc, --no-check-certificate
                        Suppress HTTPS certificate validation
  --version             Print program version and exit
  --encoder ENCODER     Optional encoder to pass to ffmpeg (default libx264)
  --audiocodec AUDIOCODEC
                        Optional audiocodec to pass to ffmpeg (default copy the codec from the original source)
  -f FILENAME, --filename FILENAME
                        Optional output filename

License

This project is licensed under the terms of the GNU General Public License v2.0. For further information, please look here or here^(DE).

This project is based on the work of CreateWebinar.com, Stefan Wallentowitz and Olivier Berger. Parts of this code have already been published under MIT license and public domain. These parts are re-released in this project under the GPL-2.0 License.