{"id":15494995,"url":"https://github.com/fracpete/bbb-render-docker","last_synced_at":"2026-05-19T04:11:43.905Z","repository":{"id":146381091,"uuid":"332902387","full_name":"fracpete/bbb-render-docker","owner":"fracpete","description":"Docker images for the BigBlueButton render tool, to generate videos from recordings.","archived":false,"fork":false,"pushed_at":"2023-02-15T23:53:25.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-19T12:16:06.473Z","etag":null,"topics":["bigbluebutton","docker","renderer"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fracpete.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-25T22:30:31.000Z","updated_at":"2021-12-15T00:38:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"15bc6765-5573-4b8c-9b10-6526a8159c41","html_url":"https://github.com/fracpete/bbb-render-docker","commit_stats":{"total_commits":24,"total_committers":2,"mean_commits":12.0,"dds":"0.20833333333333337","last_synced_commit":"b5175888ee29ec406832ae13ff91b7714501f3a4"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/fracpete/bbb-render-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fracpete%2Fbbb-render-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fracpete%2Fbbb-render-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fracpete%2Fbbb-render-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fracpete%2Fbbb-render-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fracpete","download_url":"https://codeload.github.com/fracpete/bbb-render-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fracpete%2Fbbb-render-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266717708,"owners_count":23973384,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bigbluebutton","docker","renderer"],"created_at":"2024-10-02T08:15:44.695Z","updated_at":"2026-05-19T04:11:38.865Z","avatar_url":"https://github.com/fracpete.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bbb-render-docker\nDocker image for the [BigBlueButton render](https://github.com/plugorgau/bbb-render)\ntool, which allows you to convert recorded [BigBlueButton](https://bigbluebutton.org/) \nsessions into videos (e.g., `.mp4`).\n\n\n## Docker\n\n### Prerequisites\n\nYou need docker installed on your machine:\n\n```bash\nsudo apt-get install docker.io\n```\n\n\n### Version (for latest docker image)\n\nUses the following hash of the bbb-render repo:\n\n```\nf93f900aaa4cd469d3e1479e1027687c41d1c877\n```\n\nTimestamp: Apr 13, 2022\n\n\n### Prebuilt images\n\nThe following images are available from docker hub:\n\n```\nfracpete/bbb-render:latest\nfracpete/bbb-render:2022-04-13\nfracpete/bbb-render:2021-06-10\nfracpete/bbb-render:2020-12-27\n```\n\n\n### Build local image\n\n* You can build the image locally like this:\n\n  ```bash\n  docker build -t bbbr .\n  ```\n\n* Once built, you can run the image with this command:\n\n  ```bash\n  docker run -u $(id -u):$(id -g) \\\n      -v /local/dir:/workspace \\\n      -it bbbr:latest\n  ```\n\n  **NB:** `-v` maps a folder from the host into the container. You need this \n  for downloading the presentation and converting it into a video.\n\n\n### Pushing local image to Docker Hub\n\nThe following steps push the image to Docker Hub (you need to adjust \nthe user name, of course):\n\n* log into Docker Hub\n\n  ```bash\n  docker login\n  ```\n\n* tag the image for the push\n\n  ```bash\n  docker tag \\\n      bbbr:latest \\\n      fracpete/bbb-render:latest\n  ```\n\n* push the image\n\n  ```bash\n  docker push fracpete/bbb-render:latest\n  ```\n\n* the image is then available from:\n\n  https://hub.docker.com/u/fracpete\n\n\n### Scripts\n\nThe following scripts are available in the container:\n\n* `bbbr_convert` - downloads and converts a presentation, use `-h` for a help screen\n* `bbbr_download` - just downloads a presentation (wraps `download.py`)\n* `bbbr_make_xges` - generates an xges project (wraps `make-xges.py`)\n\nFor launching the docker container and convert a presentation you can use this script \n(use `-h` to see all available options):\n\n* [scripts/bbbr_convert](scripts/bbbr_convert)\n\n\n## Examples\n\n### scripts/bbbr_convert\n\nPrerequisites:\n\n* Download the [scripts/bbbr_convert](scripts/bbbr_convert) script\n* Place the script on a directory that is in your `$PATH` environment variable \n  (e.g., `$HOME/bin` or `/usr/local/bin`)\n\nThe following steps convert a presentation into an `.mp4` video:\n\n* If necessary, create a working directory, e.g.:\n\n  ```bash\n  $HOME/bbb\n  ```\n\n* Get the link from a recorded session by copying the link from the\n  *Presentation* button in the *Formats* column.\n\n* Run the following command to generate the `PRESENTATION_NAME.mp4` \n  video file in the `$HOME/bbb` directory:\n\n  ```bash\n  bbbr_convert -u \"PRESENTATION_LINK\" -n \"PRESENTATION_NAME\" -w \"$HOME/bbb\"\n  ```\n\n\n### Docker\n\nThe following steps demonstrate how to convert a presentation into an `.mp4` video:\n\n* Create a directory to house all the files, e.g.:\n\n  ```bash\n  $HOME/bbb\n  ```\n\n* Change into that directory:\n\n  ```bash\n  cd $HOME/bbb\n  ```\n\n* Get the link from a recorded session by copying the link from the\n  *Presentation* button in the *Formats* column.\n\n* Run the `bbbr_convert` command as follows (replace `PRESENTATION_LINK` with\n  the actual link and `PRESENTATION_NAME` with the name that you want for the\n  .mp4 file) to download and convert the BBB presentation:\n\n  ```bash\n  docker run -u $(id -u):$(id -g) \\\n      -v `pwd`:/workspace \\\n      -t fracpete/bbb-render:latest \\\n      bbbr_convert -u \"PRESENTATION_LINK\" -n PRESENTATION_NAME\n  ```\n\nThe above command combines the following three commands:\n\n* Download the presentation\n\n  ```bash\n  bbbr_download \"PRESENTATION_LINK\" /workspace\n  ```\n\n* Create an xges project:\n\n  ```bash\n  bbbr_make_xges /workspace /workspace/PRESENTATION_NAME.xges\n  ```\n\n* Convert the xges project into an `.mp4` video:\n\n  ```bash\n  ges-launch-1.0 --load /workspace/PRESENTATION_NAME.xges -o /workspace/PRESENTATION_NAME.mp4\n  ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffracpete%2Fbbb-render-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffracpete%2Fbbb-render-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffracpete%2Fbbb-render-docker/lists"}