bbbmon 0.1.4

A small CLI utility to monitor bbb usage

bbbmon

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

Installation

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:

bbbmon

Run with poetry (without pip)

Clone the repo:

git clone https://code.hfbk.net/bbb/bbbmon.git

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

For bbbmon to run you need to have a bbbmon.properties file at the path specified. In this file there should be your servers secret and the server URL. You can find this secret on your server in the file /usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties (look for a line starting with securitySalt= and copy it to). If in doubt just follow the instructions the CLI gives you.