Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
  • v0.1.24
  • v0.1.23
  • v0.1.22
  • v0.1.21
  • v0.1.19
  • v0.1.18
  • v0.1.17
  • v0.1.16
  • v0.1.15
  • v0.1.14
  • v1.1
  • v.0.1.12
  • v.0.1.11
  • v.0.1.10
  • v.0.1.9
  • v.0.1.8
  • v.0.1.7
  • v.0.1.6
  • v0.1.5
20 results

bbbmon

  • Clone with SSH
  • Clone with HTTPS
  • atoav's avatar
    David Huss authored
    If the user provides a wrong parameter with --endpoint/-e
    Instead of simply telling them they are wrong, list the available
    endpoints instead.
    
    Additionally display a warning if users are on server, so they know
    their local config is ignored
    c295b620
    History

    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

    Configuration

    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/bigbluebutton.properties | grep securitySalt=

    A example configuration file could look like this:

    [bbb.example.com]
    securitySalt=MY_SUPER_SECRET_SECRET
    bigbluebutton.web.serverURL=https://bbb.example.com/
    
    [Föö]
    securitySalt=MY_SUPER_SECRET_SECRET2
    bigbluebutton.web.serverURL=https://bbb.foo.com/

    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öö

    Usage

    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.