BuildGuide

Build guide table of contents

• Get the dependencies
  • Ubuntu
  • Windows
  • OSX
• Get the source code
• Build and install
  • Unix instructions
  • Windows instructions
  • Environment variables
  • Build with debug symbols
  • Custom install prefix

Get the dependencies

The main Pothos library really only requires CMake and a compiler. Additional components require additional dependencies. If those dependencies are not available, the component does not build.

• CMake
• C++11 compiler
• python development files for python bindings
  • and numpy as a runtime requirement
• jdk for java bindings
• qt5 development files for pothos-gui
• portaudio for audio support
• graphviz for topology debug view
• SoapySDR for SDR device support

Ubuntu

Recommended apt-get install instructions for Ubuntu:

sudo apt-get install \
    libnuma-dev cmake g++ \
    libpython-dev python-numpy openjdk-7-jdk \
    qtbase5-dev libqt5svg5-dev \
    portaudio19-dev libjack-jackd2-dev \
    graphviz

Even if you are building Pothos from source, you may still want to install some of the build dependencies from our PPA:

sudo add-apt-repository -y ppa:guruofquality/pothos
sudo apt-get update

#Example: install Poco from the repository
sudo apt-get install poco-dev-min

#Example: install Soapy SDR from the repository
sudo apt-get install libsoapysdr-dev

Windows

• CMake - http://www.cmake.org/cmake/resources/software.html
• Visual studio 2012 or later

Optional dependencies based on your needs:

• Python (2.7 and up) - https://www.python.org/downloads/windows/
• Numpy (must match python version) - http://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy
• JDK - http://www.oracle.com/technetwork/java/javase/downloads/index.html
• QT5 (must match MSVC version) - http://qt-project.org/downloads

OSX

• XCode for compiler tools
• Macports for everything else

---

Get the source code

git clone https://github.com/pothosware/pothos.git
cd pothos

#for in-tree build of poco dependency library
git submodule init && git submodule update

-- UPDATING FROM EXISTING CHECKOUT --

cd pothos
git pull origin master

---

Build and install

Unix instructions

mkdir build
cd build
cmake ..
make -j4
sudo make install
sudo ldconfig #needed on debian systems
PothosUtil --self-tests
PothosGui

Windows instructions

After configuring with CMake open a Visual studio development terminal and run:

cmake --build my_build_dir --config Release
cmake --build my_build_dir --config Release --target install

• add C:\Program Files\Pothos to the %PATH%
• open cmd and run PothosUtil.exe --self-tests
• open cmd and run PothosGui.exe

Environment variables

The Pothos library needs to know its installation path. The library is compiled with the CMAKE_INSTALL_PREFIX as the default search path for modules and library resources. However, if the library is installed to a different location other than the one it was configured with, the POTHOS_ROOT environment variable can be set to reflect the new installation path.

Build with debug symbols

cmake .. -DCMAKE_BUILD_TYPE=Debug

Custom install prefix

cmake .. -DCMAKE_INSTALL_PREFIX=/opt/Pothos