Skip to main content

A small CLI utility to monitor bbb usage

Project description


A small python based CLI utility to monitor BigBlueButton-Usage.


The easiest way to install bbbmon is to install it from the Python Package Index (PyPi). This project uses python poetry for dependency management, so you could also run it without installing the package system wide, see instructions below.

Install with pip3

sudo pip3 install bbbmon --upgrade

Then run with:


Run with poetry (without pip)

Clone the repo:

git clone

Make sure you have poetry installed. Install instruction for poetry can be found here. From inside the project directory run:

poetry install

Run bbbmon with:

poetry run bbbmon


Run bbbmon config --new to create a new default configuration file. bbbmon will always ask you before it creates or overwrites anything.

Within the config you can define one or more endpoints with running bbb instances – each with it's secret and bigbluebutton-URL. You can find the secret on your server in it's config-file via

cat /usr/share/bbb-web/WEB-INF/classes/ | grep securitySalt=

A example configuration file could look like this:



The section names in the square brackets can be chosen arbitrarily (as long as they are unique) and will be used as display names (they support utf-8). It makes sense to keep them short as they can be used for filtering and/or ordering:

bbbmon meetings -e Föö


For help run:

bbbmon -h

bbbmon supports command abbreviations – these commands produce the same result:

bbbmon meetings
bbbmon meeting
bbbmon mee
bbbmon m

This works as long as there is no other command starting with the same letters.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for bbbmon, version 0.1.33
Filename, size File type Python version Upload date Hashes
Filename, size bbbmon-0.1.33.tar.gz (25.5 kB) File type Source Python version None Upload date Hashes View
Filename, size bbbmon-0.1.33-py3-none-any.whl (27.4 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page