A Django Application for better interaction of Django projects with BigBlueButton APIs.

Features:

• Create a room on BBB and store the meeting info in a model for later access
• Start a meeting having meeting id
• End a meeting having meeting id
• Create join link for a meeting with moderator or normal access
• Get meeting report (activity of users in meeting and time log of them)
• Log each meeting for later access and reportings
• Create and Delete API Hook on BBB. (Will be usefull for example to be notified when user is leaved room from BBB and get noticed in your local service)

To use django-bigbluebutton following packages are needed. If you don't have them installed, they will be installed automatically.

Django>=2.0
requests>=2.0

Note: This package is well tested on django>=2.0. But if you are using older versions, It can be used with minor changes in structure.

install using pip:

pip install django-bigbluebutton

Register app in settings.py

INSTALLED_APPS = [
    "django_bigbluebutton",
]

Now should define you Big Blue Button Server configs in settings.py:

BBB_API_URL = 'https://test.com/bigbluebutton/api/'
BBB_SECRET_KEY = 'abcdefgabcdefgabcdefgabcdefgabcdefg'

Next run migrate:

python manage.py migrate

Run tests to check if installation is done:

python manage.py test

You can follow tests.py file to see how to use this package.

By installing this app in your django project, A admin section will be added named Meeting. Under this section you can see list of open meetings, join meeting, create join link for other users with moderator or attendee permissions.

Also to enable update state of each meeting (sync with bigbluebutton) set below variable in settings.py:

UPDATE_RUNNING_ON_EACH_CALL = True

So whenever you open list of meetings in django admin, it will update state of all meetings in database with result of getMeetings API from bigbluebutton.