Skip to content


Subversion checkout URL

You can clone with
Download ZIP
BigBlueButton API gem for Ruby
Ruby Cucumber

Make it work with HTTPS

All API requests now should be able to be made using HTTPS.

refs #1706
latest commit 6af33f9baf
@daronco daronco authored
Failed to load latest commit information.
examples A few more adaptations for BBB 0.9
extras Removed useless old bot files and updated bbbot-ruby.
features Accept only version 0.9, will be enough for all 0.9.x
lib Make it work with HTTPS
spec Fix equal config.xml's that were being reported as different
.gitignore Add .bundle/ to .gitignore
.rspec Finished the basic tests for BigBlueButtonApi and more refactoring.
.ruby-version Update default ruby version to 2.2.0
.travis.yml Update default ruby version to 2.2.0
CHANGELOG.rdoc Version 1.4.0
Gemfile Updated the dependencies and increased the time window when verifying…
Gemfile.lock Improve the dependency on xml-simple yet again
LICENSE_003 Updating the license files.
README.rdoc Version 1.4.0
Rakefile A few more adaptations for BBB 0.9
bigbluebutton-api-ruby.gemspec Improve the dependency on xml-simple yet again



This is a ruby gem that provides access to the API of BigBlueButton. See the documentation of the API here.

It enables a ruby application to interact with BigBlueButton by calling ruby methods instead of HTTP requests, making it a lot easier to interact with BigBlueButton. It also formats the responses to a ruby-friendly format and includes helper classes to deal with more complicated API calls, such as the pre-upload of slides.

A few features it has:

  • Provides methods to perform all API calls and get the responses;

  • Converts the XML responses to ruby hashes, that are easier to work with;

  • Converts the string values returned to native ruby types. For instance:

    • Dates are converted DateTime objects (e.g. “Thu Sep 01 17:51:42 UTC 2011”);

    • Response codes are converted to boolean (e.g. “SUCCESS” becomes true);

  • Deals with errors (e.g. timeouts) throwing BigBlueButtonException exceptions;

  • Support to multiple BigBlueButton API versions (see below).

Supported BigBlueButton versions

The current version of this gem supports all the following versions of BigBlueButton:

  • 0.9 (includes all 0.9.x)

  • 0.81

  • 0.8

Older versions:

  • 0.7 (including 0.7, 0.71 and 0.71a): The last version with support to 0.7* is version 1.2.0. It supports versions 0.7 and 0.8.

  • 0.64: see the branch api-0.64. The last version with support to 0.64 is version 0.0.10. It supports versions 0.64 and 0.7.

Supported ruby versions

Tested in rubies:

  • ruby-2.2.0 recommended

  • ruby-2.1.2

  • ruby-2.0.0 (p353)

  • ruby-1.9.3 (p484)

  • ruby-1.9.2 (p290)

Use these versions to be sure it will work. Other patches of these rubies (e.g. ruby 1.9.3-p194) should work as well.


For a list of releases and release notes see CHANGELOG.rdoc.


Information for developers of bigbluebutton-api-ruby can be found in our wiki.

The development of this gem is guided by the requirements of the project Mconf. To know more about it visit the project’s wiki.


Distributed under The MIT License (MIT). See LICENSE for the latest license, valid for all versions after 0.0.4 (including it), and LICENSE_003 for version 0.0.3 and all the previous versions.


Version 0.0.4+: This project is developed as part of Mconf ( Contact: Leonardo Crauss Daronco (, Mconf: A scalable opensource multiconference system for web and mobile devices @ PRAV Labs - UFRGS. Home page:

Version 0.0.3 and below: Joe Kinsella (, Home page:

Something went wrong with that request. Please try again.