Getting started

Prerequisites

• rtl-sdr (http://cgit.osmocom.org/rtl-sdr/)
• libwebsockets (http://git.libwebsockets.org/cgi-bin/cgit/libwebsockets/)
• fftw3 (http://www.fftw.org/)

Building

Run make in the project root.

Running

The resulting binary is rtl-ws-server in build-directory. You should execute it from there. Default port is 8080 (hard coded for now).

The software is tested with the server running on Raspbian GNU/Linux 7 "wheezy", and the client on Google Chrome (Windows 7 x64 and Debian GNU/Linux 7 (wheezy)).

When encountering problems, check that ...

• you are able to run rtl_test/rtl_fm/rtl_whatever in your server.
• your browser actually supports the websockets.
• you don't have firewalls (routers) blocking the connection.
• you don't exhaust your cpu (e.g. check cpu load with top).
• you should use powered usb hub with RasPi... otherwise your system will probably hang randomly (learned this the hard way)