====== BBB Exports (Experimental) ======

Sometimes neither the stream recording nor a screen capture of the BBB recording really fits the format of a lecture and some video editing has to be done,
or you simply want to retrieve your annotations from a lecture for sharing.

For these cases we are providing downloadable exports (only available where recordings were also enabled).

As with recordings those exports are **not intended to be shared directly with students**.\\
You are responsible to strip them from any copyrighted material or potential data infringements before releasing them in any form to your students. Exports are also **deleted after 30 days**.

Usually it should only take a few minutes for the exports to be available, even for conferences that ran over multiple hours (which is generally not recommended as it can result in a large audio/video desync).

These exports contain:
  * Conference audio, webcams and screenshares
  * A prepared [[https://kdenlive.org/|Kdenlive]] project file, see below
  * Annotated slides exported as PDF files
  * The bbb-internal chat-log
  * A logfile of our export script (in case something goes wrong)

Not in the export:
  * Shared external videos
  * Shared notes (being worked on)
  * The chat-log from lectures.fslab.de

Poll results are inside of the raw ''events.xml'', but they are not converted in a nicely readable format (for now).



===== Editing of exports using Kdenlive =====

Included inside of the downloadable zip file is a ''.kdenlive'' file which can be opened using the [[https://kdenlive.org|Kdenlive]] video editor.

There are multiple tracks inside of the project:
  * A video track for each time a webcam has been enabled
  * A video track for each time a screenshare has been enabled
  * A video track for the presentation (including annotations as they were drawn)
  * A single audio track with the pre-mixed conference audio (that's how we get it from BBB, no multitrack audio possible)

The basic steps for editing a lecture in Kdenlive are:
  * Download the export from the conference site
  * Open the Kdenlive project file
  * Cut the presentation to make space for screenshares (if used)
  * Add transformation effects to webcam videos and place them anywhere you like
  * Set in-mark (position cursor where you want the video to start and press ''i'')
  * Set out-mark (...to stop and press ''o'')
  * Render (MP4, Selected zone)

We also have a short screencast on how to do the actual cutting: [[https://lectures.fslab.de/video/Y0FHThGYV1ptTxhj5NKi]]