Open source, multi-user SDR receiver software with a web interface

Go to file

Gnoxter fd173a920c Unify range slider look with css Make panel elements placement less fickle		2016-02-06 17:42:35 +01:00
htdocs	Unify range slider look with css	2016-02-06 17:42:35 +01:00
plugins	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00
config_rtl.py	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00
config_webrx.py	Added experimental HackRF support.	2015-10-11 01:26:49 +02:00
CONTRIBUTING.md	ICLA	2015-11-29 17:51:19 +01:00
ICLA.txt	ICLA	2015-11-29 17:51:19 +01:00
LICENSE.txt	Create LICENSE.txt	2015-11-29 18:00:35 +01:00
openwebrx.py	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00
README.md	Update README.md	2015-11-29 18:02:35 +01:00
rtl_mus.py	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00
rxws.py	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00
screenshot.png	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00
sdrhu.py	many fixes and new features like IMA ADPCM compression	2015-08-17 20:32:58 +02:00

OpenWebRX

OpenWebRX is a multi-user SDR receiver software with a web interface.

It has the following features:

libcsdr based demodulators (AM/FM/SSB),
filter passband can be set from GUI,
waterfall display can be shifted back in time,
it extensively uses HTML5 features like WebSocket, Web Audio API, and <canvas>.
it works in Google Chrome, Chromium (above version 37) and Mozilla Firefox (above version 28),
currently supports RTL-SDR and HackRF; other SDR hardware may be easily added.

News:

My BSc. thesis written on OpenWebRX is available here.
Several bugs were fixed to improve reliability and stability.
OpenWebRX now supports compression of audio and waterfall stream, so the required network uplink bandwidth has been decreased from 2 Mbit/s to about 200 kbit/s per client! (Measured with the default settings. It is also dependent on fft_size.)
OpenWebRX now uses sdr.js (libcsdr compiled to JavaScript) for some client-side DSP tasks.
Receivers can now be listed on sdr.hu.
License for OpenWebRX is now Affero GPL v3.

Setup

OpenWebRX currently requires Linux and python 2.7 to run.

First you will need to install the dependencies:

After cloning this repository and connecting an RTL-SDR dongle to your computer, you can run the server:

python openwebrx.py

You can now open the GUI at http://localhost:8073.

Please note that the server is also listening on the following ports (on localhost only):

Now the next step is to customize the parameters of your server in config_webrx.py.

Actually, if you do something cool with OpenWebRX (or just have a problem), please drop me a mail:
Andras Retzler, HA7ILM <randras@sdr.hu>

You can zoom the waterfall display by the mouse wheel. You can also drag the waterfall to pan across it.

The filter envelope can be dragged at its ends and moved around to set the passband.

However, if you hold down the shift key, you can drag the center line (BFO) or the whole passband (PBS).

If you have any problems installing OpenWebRX, you should check out the Wiki about it, which has a page on the common problems and their solutions.

Sometimes the actual error message is not at the end of the terminal output, you may have to look at the whole output to find it.

If you want to run OpenWebRX on a remote server instead of localhost, do not forget to set server_hostname in config_webrx.py.

OpenWebRX is available under Affero GPL v3 license (summary).

OpenWebRX is also available under a commercial license on request. Please contact me at the address <randras@sdr.hu> for other licensing options.