Linux
This page describes how to build/install the sigrok subprojects on Linux.
Binaries
Distribution packages
Many Linux distributions ship with sigrok packages, see Downloads.
If the sigrok packages in your distro are rather old, you can also use the AppImage we provide (see below).
AppImage
We provide AppImages (see appimage.org for details) for sigrok-cli and PulseView which make it very easy and convenient to use sigrok on somewhat recent Linux distributions (most distros newer than Ubuntu 16.04 LTS (Xenial Xerus) from around 2016 should work fine).
After downloading the AppImage (see Downloads) you can run it by simply making it executable and executing it, for example:
$ chmod u+x PulseView-NIGHTLY-x86_64.AppImage $ ./PulseView-NIGHTLY-x86_64.AppImage
You might need to install the libsigrok udev rules files to be able to access some devices, see Building#Cannot_access_USB_.2F_serial_.2F_other_device for details.
Building (script, recommended)
The most convenient method to build all of the sigrok subprojects from source is to use the sigrok-cross-linux script from the sigrok-util repo. Despite the name, this script also does native builds out of the box.
The script assumes that you have installed all requirements of all sigrok subprojects, please check Building#Build_requirements for details.
$ git clone git://sigrok.org/sigrok-util $ cd sigrok-util/cross-compile/linux $ ./sigrok-cross-linux
This will download the current git version of all required sigrok subprojects and build them, installing the results in $HOME/sr. You may want to check out the README and/or adapt the script to your needs (e.g. if you want to install elsewhere).
You can use the files from $HOME/sr using (for example) the LD_LIBRARY_PATH method.
Building (manually)
IMPORTANT: The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the official build requirements list in the wiki or the README/INSTALL file (of the subproject you want to build) for the full list of requirements.
libserialport
Installing the requirements
Debian/Ubuntu/Mint
$ sudo apt-get install git-core gcc make autoconf automake libtool
Arch
$ sudo pacman -S git gcc make autoconf automake libtool
Building
$ git clone git://sigrok.org/libserialport $ cd libserialport $ ./autogen.sh $ ./configure $ make $ sudo make install
libsigrok
Installing the requirements
Debian/Ubuntu/Mint
$ sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \ automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \ libusb-1.0-0-dev libftdi1-dev nettle-dev check doxygen python-numpy \ python-dev python-gi-dev python-setuptools swig default-jdk
Fedora (18, 19, 20, 21, 22, 23)
$ sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \ glib2-devel libzip-devel libusb1-devel libftdi-devel nettle-devel check-devel doxygen
- For C++ bindings, add sudo yum install glibmm24-devel.
- For Python bindings, add sudo yum install python-devel numpy pygobject3-devel swig.
- For Fedora 23, you need as well: redhat-rpm-config and note that libusb1-devel is now libusbx-devel.
Arch
$ sudo pacman -S git gcc make autoconf autoconf-archive automake libtool \ pkg-config glib2 glibmm libzip libusb libftdi nettle check doxygen python-numpy \ python-setuptools swig jdk8-openjdk
Building
$ git clone git://sigrok.org/libsigrok $ cd libsigrok $ ./autogen.sh $ ./configure $ make $ sudo make install
Device access
Please read this FAQ entry for any extra steps you may need to take to get your specific device working.
Please see Building#FAQ if you are sure that you installed all requirements properly but still encounter some issues.
libsigrokdecode
Installing the requirements
Debian/Ubuntu/Mint
$ sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev
Fedora (18, 19, 20)
$ sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel
Arch
$ sudo pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check
Building
$ git clone git://sigrok.org/libsigrokdecode $ cd libsigrokdecode $ ./autogen.sh $ ./configure $ make $ sudo make install
sigrok-cli
Installing the requirements
Debian/Ubuntu/Mint
$ sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev
Fedora (18, 19)
$ sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel
OpenSuse
$ sudo zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel
Arch
$ sudo pacman -S git gcc make autoconf automake libtool pkgconfig glib2
Building
$ git clone git://sigrok.org/sigrok-cli $ cd sigrok-cli $ ./autogen.sh $ ./configure $ make $ sudo make install
PulseView
Installing the requirements
Debian/Ubuntu/Mint
$ sudo apt-get install git-core g++ make cmake libtool pkg-config \ libglib2.0-dev libboost-test-dev libboost-serialization-dev \ libboost-filesystem-dev libboost-system-dev libqt5svg5-dev qtbase5-dev\ qttools5-dev
Fedora (18, 19, 23, 27)
$ sudo yum install git gcc cmake libtool pkgconfig glib2-devel \ boost-devel qt5-devel
Arch
$ sudo pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \ qt5-base qt5-svg
Building
$ git clone git://sigrok.org/pulseview $ cd pulseview $ cmake . $ make $ sudo make install
Troubleshooting
See PulseView#Building for more tips and FAQs.
SmuView
Installing the requirements
Debian/Ubuntu/Mint
$ sudo apt-get install git-core g++ make cmake libtool pkg-config \ libglib2.0-dev libboost-dev python3-dev libqt5svg5-dev qtbase5-dev \ libqwt-qt5-dev
Fedora (18, 19, 23, 27, 32)
$ sudo yum install git gcc cmake libtool pkgconfig glib2-devel \ boost-devel python3-devel qt5-devel qwt-qt5-devel
Arch
$ sudo pacman -S git gcc make cmake libtool pkgconfig glib2 boost \ python qt5 qt5-base qt5-svg qwt
Building
$ git clone https://github.com/knarfS/smuview $ cd smuview $ mkdir build $ cd build $ cmake ../ $ make $ sudo make install
Troubleshooting
See SmuView#Building for more tips and FAQs.
FAQ
Make sure to also see the Building FAQ for subjects that are not specific to Linux.
See here.
TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
See here.
Cannot access USB / serial / other device
See here.
Required library not found
See here.