Kukuruku: A new SDR client that supports RTL-SDR

A new general purpose SDR software package called “Kukuruku” has recently been released. It appears to be a Linux only based client which is based on GNURadio. The authors write that they have several interesting features which we quote below:

Network transparency. Process the data remotely and send to the client only waterfall pixels and filtered narrowband channels instead of the entire SDR baseband. With this, you can use the SDR remotely over WAN.

Multiple demodulators running at once. How the hell can this be missing?

History browsing. It happens to me all the time: I see a new station scrolling on the waterfall. Before I manage to tune to it, it disappears (or at least the callsign is over). I have 8 GB of RAM, so why can’t I store the last minute of the entire SDR baseband for future reference?

Pluggable demodulators. Why is it so much pain to add GSM, Tetra, Tetrapol and other modes to existing software? I just want to provide a binary and have the data piped to stdin.

Squelch sucks. The squelch should not care about absolute signal level, but about level relative to surrounding channels. Additionally, it should have hysteresis and a small buffer, so when it triggers, it correctly replays the beginning of the conversation. Oh, and when recording, the squelch should timestamp the parts of conversation.

Histogram. It is difficult to see clipping on the FFT output. Why don’t we have histogram of samples?

Autotune/AFC. Obvious.

Scanner. Both for automatic demodulating all peaks in the spectrum and for retuning the SDR and finding stations. Even the crappiest rtl-sdr has 2 MHz bandwidth and can retune in 50 ms. This means 1600 channels per second. Compare this with commercial scanners.

At the moment one interesting plugin for Kukuruku is the TETRA plugin. The plugin appears to use tetra-listener and TERAPOL-kit as the demodulators, and simply passes the signal data to them for decoding and audio output.

The installation instructions can be found on the user guide. So far we unfortunately haven’t been able to install and test the software due to several compilation errors occurring, so if anyone tries this out and gets it to work, please post any installation tips in the comments. 

Kukuruku running and demodulating TETRA audio with a plugin.
Kukuruku running and demodulating TETRA audio with a plugin.
Notify of

Inline Feedbacks
View all comments


I would like to know how to make kukuruku work with the current Linux system version 20.04 of lunbutu, unbuntu … if you have a solution on the installation and the configuration I am taker thank you for your help


Hello, could you create a list with the repositories that are needed to compile kukuruku and if someone has managed to make the tetrapol-kit work? Thank you


i have a chance to open kukuruku sdr, on kali linux ??i try to open kukuruku guy screenshoot, but don t work. Is not like other example…… like gqrx . or other application. or is not more specified on here?? I have error….example:
root@kali:~# cd kukuruku
root@kali:~/kukuruku# cd client
root@kali:~/kukuruku/client# make
make -C modes
make[1]: Entering directory ‘/root/kukuruku/client/modes’
make[1]: Nothing to be done for ‘all’.
make[1]: Leaving directory ‘/root/kukuruku/client/modes’……..is wrong??? what don t understand???


There is nothing wrong, this means it is already compiled…


Thank you, verry muck, for you answer Jenda.
But I have other problems, that I do not understand: when i try open write mee like:
root@kali:~# cd kukuruku
root@kali:~/kukuruku# cd client
root@kali:~/kukuruku/client# ./kukuruku-gui.py your-server:4444
Traceback (most recent call last):
File “./kukuruku-gui.py”, line 576, in
cl.connect(conf.HOST, conf.PORT)
File “/root/kukuruku/client/libclient.py”, line 164, in connect
self.sock.connect((host, port))
File “/usr/lib/python2.7/socket.py”, line 228, in meth
return getattr(self._sock,name)(*args)
socket.gaierror: [Errno -2] Name or service not known



I clone kukuruku in my home directory how I should do to make it work I have to look good help file my question is how can I find my server by default because it is a 4444 or should I add ? how and created a $ PATH with tetrapol_dump and tetra-rx?

in waiting for your response



Hi, .. i cant even get into the homepage … says the url doesent exist.



The https://brmlab.cz/user/jenda/kukuruku page should work, but there was a power outage in datacenter where the Git server is. It should be back OK.


Sorry, it was the GIT page i mean. It worked and i downloaded and tested it, but i couldent get the Tetra thing to work at all (as for example TLive).


Looks like gcc 4.x requires different order of linker arguments. Should be fixed now.

rengar paw

Server&Client run fine in my VM, but i tried to demod a FM Broadcast, and im not getting any audio.
“/home/jenda/tmp/kukuruku/client/modes/wfm.py: not found”
“works on my machine”, right?


admin: This is really weird, at first it fails to read from osmosdr and then it segfaults. Would it be possible to open the coredumo in gdb and see where it fails?

rengar paw: You need to edit path to modes directory in ~/.kukuruku/modes. Maybe “./” or the base dir of the kukuruku-gui.py script should be there by default, but then it won’t work if you put the it for example to /usr/local/bin either. How can this be solved?


Sorry, ~/.kukuruku/gui. The problem with this is that it should be in the documentation, but someone discovered this project and posted it here about one week before I planned to release it, so the documentation was not yet ready 😉


OK, can you please post (or send me) the errors to have a look?

hump me rengar

lol cant even compile, same error
nice idea, but what a pos


Binaries for ARM, ARM64, X86, X64, ……. binary is not always an easy option in Linux
And then you have all the package systems.
Sometimes source code, and satisfying all the prerequisites, can be faster with the first release of cutting edge software, once it matures then the binaries will follow.