Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

gr-bokehgui: Web based display for GNU Radio


The module provides various sinks and widgets to allow interaction with the live GNU Radio applications remotely over the network. The module uses Bokeh's client API and streaming features. Using widgets and plots from Bokeh, the module enables the GUI for GNU Radio that renders in web browser. Just like gr-qtgui, it is fully integrated with GRC to allow easy use.

The module was developed as a part of Google Summer of Code 2017 by Kartik Patel. This fork extends it for gnuradio 3.8 and updates it.


  1. GNU Radio 3.8 (should contain commit@b23bfe9)
  2. Bokeh library v1 (Tested on v1.4.0)



$ pybombs install gr-bokehgui

The pybombs recipe is not up to date with the present repository, please build from source.

Using source code

  1. Make sure that you have satisfied all dependency listed above.
  2. Clone the latest code
$ git clone
  1. Build with CMake:
$ cd gr-bokehgui/
$ mkdir build
$ cd build/
$ cmake ../
$ make
$ make test
$ sudo make install

Working with the module

The complete tutorial for the module is available here. The tutorial covers setting up guide, using sinks and widgets in GRC and guide to the placement of the elements.

Quick Glance

For the following flowgraph: tutorial.grc - flowgraph

The output should be as follows: tutorial.grc - output

The following Youtube video provides quick glance over the module and basic procedures. Youtube - demo

Bugs reporting:

Kindly report any bugs or issues on Github.

Contributing to the project

If you want to contribute to the module, feel free to add the pull request. Please read the contribution guidelines of GNU Radio here.


For queries or feedbacks, drop a mail to discuss-gnuradio.


The project is licensed under GPLv3. See LICENSE for terms.

You can’t perform that action at this time.