This repo provides a simple tty-console based SDR waterfall viewer for watching unsigned 8-bit IQ TCP streams, such as off the rtl_tcp server. It is written in python. The script ttywaterfall.py only requires that the python library numpy be installed to run. The viewer cannot control a remote radio through the stream. It can only view its output. I wanted the code to be minimal and debuggable. The FFT frame size is set by the width of the screen plus a crop factor in the code. The waterfall colors are automatically adjusted for full dynamic range.
The --step option sets the number of FFT frames averaged before being displayed as a waterfall line. Use --url to pull the stream from a URL instead. Or use --filename to read it from a file.
The code requires that your terminal support truecolor escapes. This is normally accomplished by setting 'export COLORTERM=truecolor' in your .bashrc. GNU screen has marginal truecolor support, so avoid running it inside at first. The use case of this tool is for sshing into your radios and checking reception without having to stream to the network.
usage: ttywaterfall.py [-h] [--step STEP] [--host HOST] [--port PORT]
[--url URL] [--filename FILENAME]
options:
-h, --help show this help message and exit
--step STEP step (default: 1024)
--host HOST server host (default: 127.0.0.1)
--port PORT server port (default: 1234)
--url URL url for cu8 stream (default: None)
--filename FILENAME cu8 pcm file (default: None)
Takes an input 16-bit IQ wav file and converts it to a unsigned 8-bit wav for ttywaterfall.py.