User cookbook

Linux (native)

Ubuntu 16.04 and later

# for Roc
$ sudo apt-get install g++ pkg-config scons ragel gengetopt \
    libuv1-dev libunwind-dev libpulse-dev libsox-dev libcpputest-dev

# for 3rd-parties
$ sudo apt-get install libtool intltool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=openfec

# install libraries and tools
$ sudo scons -Q --build-3rdparty=openfec install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio install

Ubuntu 14.04 and later, Debian Jessie and later

# for Roc
$ sudo apt-get install g++ pkg-config scons ragel gengetopt libunwind8-dev libpulse-dev libsox-dev

# for 3rd-parties
$ sudo apt-get install libtool intltool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=libuv,openfec,cpputest

# install libraries and tools
$ sudo scons -Q --build-3rdparty=libuv,openfec,cpputest install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=libuv,openfec,pulseaudio,cpputest

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=libuv,openfec,pulseaudio,cpputest install

Fedora 22 and later

# for Roc
$ sudo dnf install gcc-c++ pkgconfig scons ragel gengetopt \
    libuv-devel libunwind-devel pulseaudio-libs-devel sox-devel

# for 3rd-parties
$ sudo dnf install libtool intltool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=openfec,cpputest

# install libraries and tools
$ sudo scons -Q --build-3rdparty=openfec,cpputest install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio,cpputest

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio,cpputest install

Centos 7 and later

# for developer packages
$ sudo yum install epel-release

# for Roc
$ sudo yum install gcc-c++ pkgconfig scons ragel gengetopt libunwind-devel pulseaudio-libs-devel sox-devel

# for 3rd-parties
$ sudo yum install libtool intltool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=libuv,openfec,cpputest

# install libraries and tools
$ sudo scons -Q --build-3rdparty=libuv,openfec,cpputest install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=libuv,openfec,pulseaudio,cpputest

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=libuv,openfec,pulseaudio,cpputest install

openSUSE Leap and later

# for Roc
$ sudo zypper install gcc-c++ scons ragel gengetopt doxygen graphviz \
     libuv-devel libunwind-devel libpulse-devel libunwind-devel sox-devel

# for 3rd-parties
$ sudo zypper install pkg-config intltool libtool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=openfec,cpputest

# install libraries and tools
$ sudo scons -Q --build-3rdparty=openfec,cpputest install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio,cpputest

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio,cpputest install

Arch Linux

# for Roc
$ sudo pacman -S gcc pkgconf scons ragel gengetopt libuv libunwind libpulse sox

# for 3rd-parties
$ sudo pacman -S grep gawk libtool intltool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=openfec,cpputest

# install libraries and tools
$ sudo scons -Q --build-3rdparty=openfec,cpputest install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio,cpputest

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio,cpputest install

Alpine Linux

# for Roc
$ sudo apk add g++ pkgconf scons ragel gengetopt libuv-dev libunwind-dev pulseaudio-dev sox-dev cpputest

# for 3rd-parties
$ sudo apk add libtool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=openfec

# install libraries and tools
$ sudo scons -Q --build-3rdparty=openfec install

# build libraries, tools, and PulseAudio modules
$ scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio

# install libraries, tools, and PulseAudio modules
$ sudo scons -Q --enable-pulseaudio-modules --build-3rdparty=openfec,pulseaudio install

Linux (cross-compile)

See also

• Cross-compiling
• Tested boards

Raspberry Pi 2 and 3

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries, tools, and PulseAudio modules
$ docker run -t --rm -u "${UID}" -v "${PWD}:${PWD}" -w "${PWD}" \
    rocproject/cross-arm-linux-gnueabihf \
      scons -Q \
        --enable-pulseaudio-modules \
        --host=arm-linux-gnueabihf \
        --build-3rdparty=libuv,libunwind,openfec,alsa,pulseaudio:12.2,sox,cpputest

# install Roc binaries
$ scp ./bin/arm-linux-gnueabihf/roc-{recv,send,conv} <address>:/usr/bin
$ scp ./bin/arm-linux-gnueabihf/libroc.so.*.* <address>:/usr/lib
$ scp ./bin/arm-linux-gnueabihf/module-roc-{sink,sink-input} <address>:/usr/lib/pulse-12.2/modules

# install Roc dependencies
$ ssh <address> apt-get install libasound2 libpulse0 libltdl7

Raspberry Pi 1 and Zero

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries, tools, and PulseAudio modules
$ docker run -t --rm -u "${UID}" -v "${PWD}:${PWD}" -w "${PWD}" \
    rocproject/cross-arm-bcm2708hardfp-linux-gnueabi \
      scons -Q \
        --enable-pulseaudio-modules \
        --host=arm-bcm2708hardfp-linux-gnueabi \
        --build-3rdparty=libuv,libunwind,openfec,alsa,pulseaudio:5.0,sox,cpputest

# install Roc binaries
$ scp ./bin/arm-bcm2708hardfp-linux-gnueabi/roc-{recv,send,conv} <address>:/usr/bin
$ scp ./bin/arm-bcm2708hardfp-linux-gnueabi/libroc.so.*.* <address>:/usr/lib
$ scp ./bin/arm-bcm2708hardfp-linux-gnueabi/module-roc-{sink,sink-input} \
    <address>:/usr/lib/pulse-5.0/modules

# install Roc dependencies
$ ssh <address> apt-get install libasound2 libpulse0 libltdl7

Orange Pi 64-bit models

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries, tools, and PulseAudio modules
$ docker run -t --rm -u "${UID}" -v "${PWD}:${PWD}" -w "${PWD}" \
    rocproject/cross-aarch64-linux-gnu \
      scons -Q \
        --enable-pulseaudio-modules \
        --host=aarch64-linux-gnu \
        --build-3rdparty=libuv,libunwind,openfec,alsa,pulseaudio:8.0,sox,cpputest

# install Roc binaries
$ scp ./bin/aarch64-linux-gnu/roc-{recv,send,conv} <address>:/usr/bin
$ scp ./bin/aarch64-linux-gnu/libroc.so.*.* <address>:/usr/lib
$ scp ./bin/aarch64-linux-gnu/module-roc-{sink,sink-input} <address>:/usr/lib/pulse-8.0/modules

# install Roc dependencies
$ ssh <address> apt-get install libasound2 libpulse0 libltdl7

Orange Pi 32-bit models

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries, tools, and PulseAudio modules
$ docker run -t --rm -u "${UID}" -v "${PWD}:${PWD}" -w "${PWD}" \
    rocproject/cross-arm-linux-gnueabihf \
      scons -Q \
        --enable-pulseaudio-modules \
        --host=arm-linux-gnueabihf \
        --build-3rdparty=libuv,libunwind,openfec,alsa,pulseaudio:8.0,sox,cpputest

# install Roc binaries
$ scp ./bin/arm-linux-gnueabihf/roc-{recv,send,conv} <address>:/usr/bin
$ scp ./bin/arm-linux-gnueabihf/libroc.so.*.* <address>:/usr/lib
$ scp ./bin/arm-linux-gnueabihf/module-roc-{sink,sink-input} <address>:/usr/lib/pulse-8.0/modules

# install Roc dependencies
$ ssh <address> apt-get install libasound2 libpulse0 libltdl7

macOS

macOS 10.12 and later

# for Roc
$ brew install scons ragel gengetopt sox libuv cpputest

# for 3rd-parties
$ brew install libtool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=openfec

# install libraries and tools
$ sudo scons -Q --build-3rdparty=openfec install

macOS 10.11 and later

# for Roc
$ brew install scons ragel gengetopt cpputest

# for 3rd-parties
$ brew install libtool autoconf automake make cmake

# clone repo
$ git clone https://github.com/roc-streaming/roc-toolkit.git
$ cd roc-toolkit

# build libraries and tools
$ scons -Q --build-3rdparty=libuv,openfec,sox

# install libraries and tools
$ sudo scons -Q --build-3rdparty=libuv,openfec,sox install

Android

Warning

Android support is still work in progress and was not properly tested yet.

See also

• Cross-compiling

Termux packages

Warning

Termux package for Roc may be outdated.

Install Termux on your device and enter these commands:

$ pkg install unstable-repo
$ pkg install roc
$ pkg install pulseaudio

This will install binary packages for PulseAudio daemon and Roc PulseAudio modules on your device. Then you can configure PulseAudio to run Roc as described in PulseAudio modules.