Jigasi

To use Google Cloud Speech-to-Text, you must install the Google Cloud SDK and provide credentials to Jigasi.

1. Install Google Cloud CLI (Debian/Ubuntu):

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
   echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
   sudo apt-get update && sudo apt-get install google-cloud-cli
   gcloud init
   gcloud auth application-default login

2. Setup Credentials: Move the generated credentials to the Jigasi config directory and set permissions:

   mv /root/.config/gcloud/application_default_credentials.json /etc/jitsi/jigasi
   chown jigasi:jitsi /etc/jitsi/jigasi/application_default_credentials.json

3. Update Jigasi Config: Add the following to /etc/jitsi/jigasi/config:

   GOOGLE_APPLICATION_CREDENTIALS=/etc/jitsi/jigasi/application_default_credentials.json

# Credential for Google Cloud Speech API
GOOGLE_APPLICATION_CREDENTIALS=/etc/jitsi/jigasi/application_default_credentials.json

To use Jigasi as a transcription provider, you must configure a hidden domain in Prosody and update the Jitsi Meet configuration.

1. Prosody Configuration: Add a VirtualHost for the recorder in /etc/prosody/conf.d/meet.example.com.cfg.lua:

   VirtualHost "recorder.meet.example.com"
     modules_enabled = {
       "ping";
     }
     authentication = "internal_hashed"

2. Register Transcriber:

   prosodyctl register transcriber recorder.yourdomain.com jigasirecorderexamplepass

3. Jitsi Meet Configuration: Edit /etc/jitsi/meet/meet.example.com-config.js:

   config.hiddenDomain = "recorder.meet.example.com";
   config.transcription = { enabled: true };

4. Jigasi Configuration: Edit /etc/jitsi/jigasi/sip-communicator.properties:

   org.jitsi.jigasi.ENABLE_SIP=false
   org.jitsi.jigasi.ENABLE_TRANSCRIPTION=true
   org.jitsi.jigasi.xmpp.acc.USER_ID=transcriber@recorder.meet.example.com
   org.jitsi.jigasi.xmpp.acc.PASS=jigasirecorderexamplepass
   org.jitsi.jigasi.xmpp.acc.ANONYMOUS_AUTH=false
   org.jitsi.jigasi.xmpp.acc.ALLOW_NON_SECURE=true

To use a Vosk speech recognition server:

1. Start Vosk (via Docker):

   docker run -d -p 2700:2700 alphacep/kaldi-en:latest

2. Configure Jigasi in sip-communicator.properties:
   • Set the service: org.jitsi.jigasi.transcription.customService=org.jitsi.jigasi.transcription.VoskTranscriptionService
   • Set the URL (single instance): org.jitsi.jigasi.transcription.vosk.websocket_url=ws://localhost:2700
   • For multiple languages, use a JSON format: org.jitsi.jigasi.transcription.vosk.websocket_url={"en": "ws://localhost:2700", "fr": "ws://localhost:2710"}

org.jitsi.jigasi.transcription.customService=org.jitsi.jigasi.transcription.VoskTranscriptionService
# Single instance
org.jitsi.jigasi.transcription.vosk.websocket_url=ws://localhost:2700
# Multiple instances
# org.jitsi.jigasi.transcription.vosk.websocket_url={"en": "ws://localhost:2700", "fr": "ws://localhost:2710"}

For outgoing calls, Jigasi uses a control room called a 'brewery' (an XMPP MUC). To use this, you must:

1. Enable the brewery in sip-communicator.properties: org.jitsi.jigasi.BREWERY_ENABLED=true.
2. Add an XMPP account to connect to the server. A sample configuration for an account jigasi@auth.meet.example.com is provided in the documentation.
3. Configure Jicofo: The brewery room name must be registered in Jicofo using:
   • Property: org.jitsi.jicofo.jigasi.BREWERY=JigasiBrewery@internal.auth.meet.example.com
   • Or via HOCON: hocon -f /etc/jitsi/jicofo/jicofo.conf set jicofo.jigasi.brewery-jid '"JigasiBrewery@internal.auth.meet.example.com"'
4. Configure Prosody: Ensure Prosody has a registered MUC component at internal.auth.meet.example.com.

# Example XMPP account property for brewery
net.java.sip.communicator.impl.protocol.jabber.acc-xmpp-1.BREWERY=JigasiBrewery@internal.auth.meet.example.com