inspect_jitsi.sync.participants module#

get_participants: a one-shot list of who's in a Jitsi Meet room.

Briefly opens a JitsiConference, reads the participant roster, and closes it again - see that class and the inspect_jitsi.xmpp.connection module docstring for why joining the room is necessary and what it means in practice (a brief join/leave blip other participants may notice).

inspect_jitsi.sync.participants.get_participants(conference_url, nick=None, name=None, anonymous_domain=None, muc_domain=None, timeout=10)[source]#

Return the participants currently in a Jitsi Meet room.

Parameters:

  • conference_url (str) – e.g. "https://meet.example.com/SomeRoomName".

  • nick (str | None) – the MUC nickname to join under. Random if not given.

  • name (str | None) – the display name (XEP-0172) to disclose when joining. No display name is disclosed if not given.

  • anonymous_domain (str | None) – override the XMPP domain used for stream/login. Auto-discovered from the site's /config.js if not given.

  • muc_domain (str | None) – override the MUC component domain (e.g. "muc.meet.jitsi" or "conference.example.com"). Auto-discovered if not given.

  • timeout (float) – seconds to wait for each network step.

Return type:

list[Participant]

Returns:

The participants already in the room, not counting this probe (empty if the room is empty).

Raises:

inspect_jitsi.xmpp.JitsiConnectionError – the XMPP connection failed or was lost (refused, dropped, timed out, or an unparseable server response).