Installation

LuaRadio can be installed from the AUR on Arch Linux, from a PPA on Ubuntu, from Homebrew on Mac OS X, or from source.

Packaging for other distributions and platforms is a work in progress.

To try LuaRadio without installation, you can run it directly from the repository, provided LuaJIT is installed. The real-time dependencies described below will also be necessary for real-time applications.

Installing from Arch Linux AUR

LuaRadio is available in the Arch Linux AUR under the package luaradio.

Desktop users should also install the gnuplot package for plotting support.

Installing on Ubuntu 16.04, 14.04

LuaRadio is available through a PPA for Ubuntu 16.04 (Xenial Xerus) and Ubuntu 14.04 (Trusty Tahr), under amd64, i386, and armhf architectures.

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:vsergeev/luaradio
sudo apt-get update
sudo apt-get install luaradio

Note: Users should install liquid-dsp or VOLK for real-time acceleration. liquid-dsp is not yet available in the PPA. liquid-dsp or VOLK can be installed from source. On Ubuntu 16.04, VOLK can be installed with the libvolk1-dev package.

Desktop users should also install the gnuplot5 or gnuplot package for plotting support.

Installing from Homebrew on Mac OS X

LuaRadio is available in Homebrew for Mac OS X:

brew install luaradio

Note: Users should install liquid-dsp or VOLK for real-time acceleration. liquid-dsp is not yet available in Homebrew. liquid-dsp or VOLK can be installed from source.

Desktop users should also install the gnuplot package for plotting support.

Installing from Source

Install prerequisites

Install LuaJIT 2.0.4 or greater:

  • Arch Linux: luajit
  • Ubuntu/Debian: luajit, libluajit-5.1-dev,pkg-config
  • Fedora, CentOS/RHEL/SL 7 or up: luajit, luajit-devel
  • Mac OS X (Homebrew): luajit, pkg-config

Install LuaRadio

Build and install LuaRadio:

git clone https://github.com/vsergeev/luaradio.git
cd luaradio/embed
make lib
sudo make install

Install real-time dependencies

LuaRadio has no hard dependencies outside of LuaJIT, but for real-time applications, the liquid-dsp or VOLK, and fftw libraries are strongly encouraged for appreciable performance. VOLK depends on boost.

  • Arch Linux: fftw, liquid-dsp-git (AUR) or libvolk
  • Ubuntu/Debian: fftw3, libfftw3-dev, liquid-dsp or VOLK from source
  • Fedora, CentOS/RHEL/SL 7 or up: fftw, fftw-devel, liquid-dsp or VOLK from source
  • Mac OS X (Homebrew): fftw, liquid-dsp or VOLK from source

Run sudo ldconfig after library installation on Linux platforms, to update the shared library cache.

Install optional dependencies

Desktop users should also install the gnuplot package for plotting support.

Some I/O blocks, like SDR and audio sources/sinks, may require additional external libraries.

Check Installation

Check the installation by dumping the platform information:

$ luaradio --platform
luajit          LuaJIT 2.0.4
os              Linux
arch            x64
page size       4096
cpu count       4
cpu model       Intel(R) Core(TM) i5-4570T CPU @ 2.90GHz
features
    fftw3f      true
    volk        true
    liquid      true
$

The liquid, volk, and fftw3f features should be marked true, if the respective libraries were found by LuaRadio.