Skip to content

Latest commit

 

History

History
111 lines (90 loc) · 4.1 KB

README.md

File metadata and controls

111 lines (90 loc) · 4.1 KB
Raw

KiwiIRC - Audio / Video conferencing

This plugin integrates the Jitsi Meet conference software into KiwiIRC.

Features -

  • Individual conference rooms for channels and private messages
  • Video, audio, or both, directly within Kiwi IRC itself
  • Continue using Kiwi IRC and other channels without dropping the conference call
  • Channel operators automatically promoted to conference room moderators

Building

yarn && yarn build

Copy dist/plugin-conference.js to your Kiwi plugins folder

Loading the plugin into Kiwi IRC

Add the plugin javascript file to your kiwiirc config.json and configure the settings:

{
    "plugins": [
        {
            "name": "conference",
            "url": "static/plugins/plugin-conference.js"
        }
    ],
    "conference": {
        "server": "meet.jit.si",
        "secure": false
    }
}

Security note!

By default, this plugin uses Jisti's public servers. It should be noted that by using these public servers, your conference calls are not secure in that anybody can join them if they can guess the room name.

Note that the "secure" option enables JWT authentication, but will not work on Jitsi's public server.

Extra configuration

Jitsi Meet supports extra configuration to customise its interface and functions. You can configure these via the optional interfaceConfigOverwrite and configOverwrite config options.

The defaults are:

"conference": {
    "secure": false,
    "server": "meet.jit.si",
    "queries": true,
    "channels": true,
    "buttonIcon": "fa-phone",
    "viewHeight": "40%",
    "enabledInChannels": ["*"],
    "groupInvitesTTL": 30000,
    "maxParticipantsLength": 60,
    "participantsMore": "more...",
    "inviteText": "{{ nick }} is inviting you to a private call.",
    "joinText": "{{ nick }} has joined the conference.",
    "joinButtonText": "Join now!",
    "showLink": false,
    "useLinkShortener": false,
    "linkShortenerURL": "https://x0.no/api/?{{ link }}",
    "linkShortenerAPIToken": "API_KEY_HERE",
    "interfaceConfigOverwrite": {
        "SHOW_JITSI_WATERMARK": false,
        "SHOW_WATERMARK_FOR_GUESTS": false,
        "TOOLBAR_BUTTONS": [
            "microphone", "camera", "fullscreen", "hangup",
            "settings", "videoquality", "filmstrip", "fodeviceselection",
            "stats", "shortcuts",
        ],
    },
    "configOverwrite": {
        "startWithVideoMuted": true,
        "startWithAudioMuted": true,
    },
}

The 'showLink' item, if enabled, will append a direct link to the broadcasted join message which opens the jitsi conference for non-Kiwi users. The 'useUseLinkShortener' item, if enabled (requires showLink to also be enabled), will shorten the link displayed using a link shortening service like Bitly. If you like, you can sign up for a free Bitly account to use the API (https://bitly.com/). Once registered, follow the instructions to generate an access token, then provide that in Kiwi's config @ "linkShortenerAPIToken". Note that some services, like x0.no do not require API tokens, in which case the token can be omitted.

Examples of linkShortenerURL data are:

If using Bitly:

`https://api-ssl.bitly.com/v3/shorten`

Alternative shortener that doesn't require an API token:

`https://x0.no/api/?{{ link }}`

note: for link shorteners other than Bitly {{ link }} is replaced with the conference url and the response is read from the body

More info about Jitsi's options can be found in these files:

You may also choose to hide the conference call icon in either channels or private messages:

{
    "channels": false,
    "queries": false
}

Running your own conference server

Running your own conference server allows you to secure your conference rooms. We make use of the Jitsi Meet server to handle the conference calls, the installation steps can be found here: https://github.com/jitsi/jitsi-meet/blob/master/doc/quick-install.md

License

Licensed under the Apache License, Version 2.0.