Galene-SIP is a work in progress gateway between the Galene videoconferencing server and the SIP protocol. It currently has the following features:

• register with a SIP registrar, over both IPv4 and IPv6;
• receive SIP calls (handle invites) and bridge them to Galene;
• handle SIP reinvites (put on hold);
• recode audio from SIP to Galene;
• decode, mix and reencode audio from Galene to SIP;
• silence detection;
• enough NAT traversal to work with most registrars even when behind NAT.

This is, however, a work in progress, and the following SIP features need implementing:

• more NAT traversal (keepalives, STUN, GRUU, RTCP multiplexing);
• SIP over TCP and SIP over TLS;
• referrals (call transfer, RFC 3515);
• session timers (RFC 4028);
• client offers (a mandatory part of the specification, but apparently not widely used);
• timestamps and statistics in RTCP.

Galene-SIP requires the libopus library. On Debian-based systems, please do:

apt install libopus-dev

Then do:

go build -ldflags='-s -w'

If the Go compiler complains with an obscure error message about libopus, then try enabling Cgo and specifying the path to your C compiler:

CGO_ENABLED=1 CC=/path/to/your/c/compiler go build -ldflags='-s -w'

Your SIP provider has provided you with four items of data:

• your SIP address, for example sip:[email protected];
• your SIP password, for example 1234;
• the SIP registrar to use, for example sip.example.com;
• the SIP proxy address to use, for example sip.example.com.

The registrar and proxy addresses are usually (but not always) equal to the domain name in the SIP address.

Your Galene administrator has provided you either with a Galene invite, of the form

• https://galene.example.org:8443/group/conference/?token=XXXX

or a Galene URL without a token together with a username and password.

In the common case, it is enough to run

./galene-sip -sip sip:[email protected] -sip-password 1234 \
             https://galene.example.org:8443/group/conference/?token=XXXX

You may use the option -sip-registrar if the registrar is different than the domain part of your SIP address. You may use the options -username and -password if your Galene URL does not contain a token. Please type

./galene-sip -help

for more information.

Now call your SIP address, and your call should be bridged to the Galene group. If something goes wrong, run with the option -debug and send me the log.

— Juliusz Chroboczek