Repolode
Submit
jitsi

jitsi/jibri

Jibri is a service that records or live-streams Jitsi Meet conferences by running headless Chrome and ffmpeg on a separate machine.

View on GitHub
Stars
672
Forks
326
Open issues
99
Last commit
11 days ago

What is it?

Jibri is the recording and streaming infrastructure for Jitsi Meet. It launches a Chrome instance rendered in a virtual framebuffer, then captures and encodes the output with ffmpeg. It is meant to run on a dedicated machine or VM with no other applications using the display or audio devices, and a single Jibri handles only one recording at a time.

Setting it up involves several pieces: an ALSA loopback audio device, an ffmpeg build with X11 capture, a Chrome and Chromedriver pair, and a Jitsi Debian package repository for installation. Jibri also needs matching configuration in Prosody (an internal MUC component and a recorder virtual host), Jicofo, and the Jitsi Meet web config so that Jibri instances can be discovered and controlled.

Jibri only works with a full Jitsi Meet installation; other frontends are not supported. Its configuration lives in a jibri.conf file in HOCON-style syntax, with defaults in reference.conf.

Key features

  • 01Records Jitsi Meet conferences by capturing a headless Chrome session with ffmpeg.
  • 02Supports live streaming of conferences using a stream key.
  • 03Discovered and controlled by Jicofo through an internal XMPP MUC.
  • 04Configured through a jibri.conf file with per-environment XMPP settings.
  • 05Installable from the Jitsi Debian repository as a system service.

Use cases

  • Recording video meetings hosted on a self-managed Jitsi Meet server.
  • Live-streaming a Jitsi Meet conference to an external platform.
  • Running a pool of recorder machines behind one Jitsi Meet deployment.

Quick start

  1. 1

    Add the Jitsi repository signing key (the README pipes a download into sh, so run it manually from the README)

  2. 2

    Create the Jitsi stable repository source list

    echo 'deb [signed-by=/usr/share/keyrings/jitsi-keyring.gpg] https://download.jitsi.org stable/' | sudo tee /etc/apt/sources.list.d/jitsi-stable.list > /dev/null
  3. 3

    Update your package list

    sudo apt-get update
  4. 4

    Install jibri

    sudo apt-get install jibri

Things to know

  • Built and tested only on Ubuntu 18.04; other distributions may not work.
  • Requires a full-fledged Jitsi Meet installation and does not work with other frontends.
  • Needs a separate machine or VM, plus ALSA loopback, Chrome and ChromeDriver setup.
  • Only one recording at a time is supported per jibri instance.

In collections

Streaming tools

Topics

#video-conferencing#recording#streaming#ffmpeg#webrtc#xmpp#chrome#hacktoberfest

FAQ

What is jibri?
Jibri is a service that records or live-streams Jitsi Meet conferences by running headless Chrome and ffmpeg on a separate machine. Jibri is the recording and streaming infrastructure for Jitsi Meet. It launches a Chrome instance rendered in a virtual framebuffer, then captures and encodes the output with ffmpeg. It is meant to run on a dedicated machine or VM with no other applications using the display or audio devices, and a single Jibri handles only one recording at a time.
Is jibri free to use? What license does it have?
jibri is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is jibri still maintained?
Actively maintained. The last commit to jibri was on Oct 27, 2026.
What can I use jibri for?
Recording video meetings hosted on a self-managed Jitsi Meet server. Live-streaming a Jitsi Meet conference to an external platform. Running a pool of recorder machines behind one Jitsi Meet deployment.
How do I install jibri?
Add the Jitsi repository signing key (the README pipes a download into sh, so run it manually from the README) Create the Jitsi stable repository source list: echo 'deb [signed-by=/usr/share/keyrings/jitsi-keyring.gpg] https://download.jitsi.org stable/' | sudo tee /etc/apt/sources.list.d/jitsi-stable.list > /dev/null Update your package list: sudo apt-get update Install jibri: sudo apt-get install jibri
Where can I get jibri?
The source code and installation instructions are on GitHub: https://github.com/jitsi/jibri

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects