installation

norc is written in Haxe and runs on HashLink. It needs the haxelibs hxmpp and sasl.

git clone --recursive https://github.com/tong/norc
cd norc
make            # norc.hl: HashLink bytecode, run with `hl norc.hl`
make norc       # norc: single binary (Linux: static with musl, needs musl-gcc)
make install    # /usr/local/bin/norc (PREFIX=~/.local for your user)

make norc needs the hashlink haxelib (for HashLink/C code), from the submodule: haxelib dev hashlink lib/hashlink/other/haxelib. It compiles HashLink from the submodule lib/hashlink into the binary (HASHLINK_SRC to use another checkout). make install-completion installs the zsh or bash completion of your login shell (COMPLETION="zsh bash" for others).

The version (norc --version) comes from git: the tag of the commit (e.g. v0.1.0 → 0.1.0), else the last tag with the commits since it, the commit and uncommitted changes as semver build metadata (0.1.0+5.g885f830.dirty). Without git, set it with -D norc_version=0.1.0 (and norc_tag, norc_commit, norc_date, norc_dirty).

Release binaries for Linux (x86-64, arm64), macOS and Windows are built by the GitHub workflow release: one archive per platform with norc and norc-rtc (calls, see below).

norc.hl only runs on x86/x86-64 (HashLink's JIT); on ARM, e.g. a Raspberry Pi, use the single binary. To build it on a system without Haxe, generate the C code elsewhere (haxe build.hlc.hxml), copy out/ and run make from-c.

Calls: norc-rtc

The audio and video of calls run in a separate program, norc-rtc (C, with GStreamer). It needs GStreamer with webrtcbin, libnice and json-glib (Arch: gst-plugins-bad gst-plugins-good libnice json-glib, Debian/Ubuntu: libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-nice libjson-glib-dev):

make norc-rtc       # then make install installs it next to norc
rtc/loopback.py     # test: two norc-rtc connected to each other (--real: your microphone and speaker)

norc finds it in PATH, or set call_helper. Without it, norc works as before, without calls.

The release archives contain norc-rtc next to norc; norc finds it there. On Linux and macOS it uses the GStreamer of the system (the packages above, macOS: brew install gstreamer libnice-gstreamer json-glib); the Windows zip contains everything, in a folder norc (bin\ with norc.exe, norc-rtc.exe and the DLLs, lib\ with the GStreamer plugins): add norc\bin to PATH.

Shell completion

zsh: extras/zsh/_norc, bash: extras/bash/norc, installed by make install-completion (see the comments in the files for manual installation).