omnimeet / jitsi
Omnimeet Jitsi: a video meeting on a Jitsi Meet instance - one's own, a public one, or 8x8's Jitsi as a Service - embedded through the IFrame API and driven from the page, a JSON Web Token per participant (shared secret or key pair), several people, JaaS webhooks read and their signature checked.
Requires
- php: >=8.2
- omnisense/omnimeet: ^1.0
Requires (Dev)
- ext-openssl: *
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^11.0
Suggests
- ext-openssl: Tokens signed with a private key (RS256): Jitsi as a Service, or an instance that validates against a public key server
Provides
None
Conflicts
None
Replaces
None
README
A video meeting on a Jitsi Meet instance, for omnisense/omnimeet: your own instance, a public one, or 8x8's Jitsi as a Service - embedded in the page through Jitsi's IFrame API and driven from it, a JSON Web Token per participant where the instance checks one, several people. Nothing is asked of the instance by this package: a Jitsi room exists from the moment its first participant comes in, and a token is signed on this side.
$gateway = (new JitsiGatewayFactory())->create(['domain' => 'meet.example.org', 'app_id' => 'my_app', 'app_secret' => $secret]); $meeting = $gateway->open(new Meeting($token, $startsAt, $endsAt)); $meeting->reference; // the room's name: 32 hex characters, the same for the same key $access = $gateway->join($meeting, Participant::host('u42', 'Dr Tilleul', 'fr')); $access->url; // https://meet.example.org/<room>?jwt=...#config...: a frame, or a link $access->script; // public/js/jitsi.js: drives the frame through the IFrame API $access->options; // domain, api, room, role, jwt, name, locale, config $access->origins; // ['https://meet.example.org']: say so before loading anything
omnimeet: gateways: group: factory: jitsi options: domain: meet.example.org # required app_id: my_app # with app_secret: a token per participant (HS256) app_secret: '%env(JITSI_APP_SECRET)%'
It does open and join, and notify with a JaaS webhook_secret. Not close nor
fetch: Jitsi's documentation shows no way to end a conference or read its state from a
server - a moderator's page ends it through the IFrame API (jitsi.js does, on omnimeet:end).
thirdParty: true unless the instance is yours; endToEnd: false: the instance's bridge carries
the media.
Documentation: the three kinds of instance, the token, the frame, an instance
that refuses to be framed (embed: false), the webhooks, and what was verified - a real meeting
on a public open instance; tokens, JaaS and webhooks against the documentation only.
Install
composer require omnimeet/jitsi
It requires omnisense/omnimeet ^1.0, installed with it. A real call needs: a Jitsi Meet instance
(its domain; its app id and secret when it asks for tokens), or a Jitsi as a Service account (its
key pair). Nothing is called: a room exists when its first participant comes in. With no account,
its tests run on recorded answers (a MockHttpClient), and
omnisense/omnimeet's
README has a first call that runs without one.
Responsibility
This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by 8x8, Inc. (Jitsi, meet.jit.si, JaaS), nor by whoever runs the instance it is pointed to. It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.
Whoever installs and runs this package is responsible for complying with the terms of the instance
it reaches (for meet.jit.si, meet.jit.si Terms of
Service; for JaaS, 8x8's JaaS
terms), for obtaining whatever they require (an
account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect),
and for any use made of what it returns. What those terms say is declared as data in
policy-meet-jit-si.json, policy-jaas.json and policy.json (docs). The authors publish it free of charge, make no commercial
use of it, and accept no liability for how it is used (see LICENSE).
License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.