User Tools

Site Tools


User guide

git clone

We test the client on Debian 9 and the server on Debian 8, Debian 9 and Ubuntu 14.04. Howeverer, it should run on any distribution and probably on other UNIX systems too.



cd server
./ rtl=0 2048000 10 # osmosdr args, samplerate, ppm, listen address

There is no security in the protocol. Use ipsec, ssh tunneling, openvpn, etc.



  • python-gtk2
  • GnuRadio
  • protobuf-compiler
  • python-protobuf
  • python-pygame

grcc was broken in 3.7.10, and was fixed recently.

Build it and install it:

cp -a .kukuruku ~
# edit path to modes directory in ~/.kukuruku/modes
cd client
./ your-server:4444

FM demodulator is builtin, for other modes, you will need to install additional packages:


You need “tetra-rx” in your $PATH. Install tetra.

It dumps traffic data to /tmp/tetra-dumpdir. You can decode the channel with

codec/c-code/cdecoder traffic_666_1.out cdata

and then create a .cdata.bz2 with

cat cdata | gr-pack | bzip2 > cdata.bz2

You can play the resulting file with cdp.


You need “tetrapol_dump” in your $PATH. Install tetrapol.

RS92-SGPL Weather sonde

You need “rs92ecc” (for old RS92 sondes) and/or “rs41ecc” (for modern RS41 sondes) in your $PATH. Install

Additionally, you need a fresh GPS almanac in /tmp/alma.bin to decode satellite data. You can download it here. The site denies usage of wget; use empty or Firefox user-agent to get around it.


  • Right click on frequency to pick a demodulator.
    • Ctrl+right click to demodulate from history buffer
  • Left click on a running demodulator to fine-tune, drag and drop to retune.
  • Scroll on a running demodulator to change filter to narrower/wider.
  • Press the “Scale waterfall” button to adjust the dynamic range.


You can easily roll out your own client!

import libclient
cl = libclient.client()
cl.connect("", 4444)
cl.create_xlater(frequency, decimation, my_filter, my_demodulator, -1)

See the example in

kukuruku/guide.txt · Last modified: 2018-05-19 19:58:43 (external edit)