fossasia / bbb-download Goto Github PK

License: Apache License 2.0

CSS 35.30% JavaScript 53.35% HTML 6.25% Python 5.09% Procfile 0.01%

bbb-download's Introduction

BBB Video Exporter

The goal of this project is to enable the export of video and presentations from BigBlueButton instances. You can use this project through the commandline interface executing a script or through the user a web interface in a browser. You do not need to install the BBB video exporter on the BBB server itself. You can set it up anywhere and copy the original URL of the video you want to export into the form field of the BBB video exporter.

How to use BBB Video Exporter

There are two ways to use this application a) per script and b) per user web interface in a browser.

Usage per script

Create and activate virtual environment

python3 -m venv venv
source venv/bin/activate

Install dependencies

Python 3.8

pip install -r requirements.txt

Run python scripts/download_presentation.py <bbb_server_url> <recording_id>

python scripts/download_presentation.py https://video2.eventyay.com 7145654166c22082657db53281dde109b7b2735e-1615943110349

Usage per web GUI

Enter video URL and click download button.
Extract the downloaded zip.
Run basic http server in the directory.

python3 -m http.server

Open http://localhost:8080/playback.html with meetingId in params.
e.g. http://0.0.0.0:8000/playback.html?meetingId=8b17c624f047b18a995c7469c2f9d3e5c4ccb560-1629196080320

Credits

accornmediaplayer Copyright (C) 2010 Cristian I. Colceriu License: MIT License
bbb-playback Copyright (c) 2012 BigBlueButton Inc. License: LGPL License

bbb-download's People

Contributors

Stargazers

Watchers

Forkers

xeon-zolt bartoszek alxhoff ranjitkshah sachinchauhan2889 pc-beast 12-malak mobasherah12 krrishnesh yasinmillers bhuwansingh aishar99ngp biratdatta abokmadaki endrain vaibhav-60

bbb-download's Issues

Setup auto deployment to dokku from this repo

We now have our dokku server. The next step is to auto-deploy to that dokku server from this repo.

Find a way to run the player without running it over http

In the current system, the player requires an HTTP server in the background to run. As all the user are not very comfortable with this system and it also requires users to have technical knowledge of choosing and hosting it locally on a server. So please find a solution to remove this extra step.

Update License on files used from other projects

Compare https://github.com/ghinda/acornmediaplayer

Player.js https://github.com/bigbluebutton/bbb-playback

Add cron job to delete the recording every 30 minutes

Add Download buttons

Add two download buttons:

For downloading the files with web player
For downloading MP4

Security Vulnerability

What would be the right contact to report a security vulnerabilty? thanks!

ImportError: cannot import name 'get_terminal_size'

hi everyone! I'm dealing with this problem.. what am I possibly doing wrong? I followed all the steps for "Usage per script".

Regards!

Create a dokku deployment for the project

We have our own dokku server. Use that server to deploy the project instead of Heroku.

Create a downloadable Zip including all media files

We need a downloadable zip that can be uploaded to a server and host the data elsewhere.
Example of a video is here https://fossasia.github.io/bbb-download/playback?meetingId=694b56a4697fc3b09cd26eee05cd019ad92d19ac-1615706688301&baseUrl=https://eventyay-bbb-recordings.s3.us-west-002.backblazeb2.com

How can we have it in a zip and deploy it elsewhere?

Virtual Events: Explore option to add live streaming to BBB

The standard BBB way does not provide livestreaming for Big Blue Button. There is a community plugin, that might be helpful here https://github.com/aau-zid/BigBlueButton-liveStreaming. Evaluate and propose options to live stream BBB events.

Document the origins of components of this project in the Readme

This project uses different components or ideas from existing projects. Please document them in the Readme.

Add option to download/generate media include or excluding chat

Please provide an option to generate the site including or excluding chat.

Provide a tick box "Include Chat". By default tick the box.

Improve width of content area for medium and small screens

The width of the content area needs to be changed as follows:

Medium screens: Do not make the central area too thin
Small screens and mobile views: Use the entire width.

Create a web UI for the script.

Make a simple web interface with
a) a form box for the link to the original BBB and
b) a button "Download".
c) Show a progress bar for the user to see the progress.

Make the design similar to the eventyay web generator.

Add preview button for users.

Currently, the system requires users to have an HTTP server setup. To increase accessibility we can serve the recordings on our servers with a preview button.