OpenWebRX

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

---

⚠️ From 2019-12-29 OpenWebRX development is discontinued. ⚠️

I'm would like to say a big thanks to everyone who supported me during this project, including those who contributed either code or donations. It has been a very fruitful 6 years, but now it's time to move on to other projects. See also my blog about that.

(@simonyiszk, please keep this GitHub repo for historic purposes.)

Know limitations of the last version:

• Python 2.7, a main dependency of the project, will be not be officially maintained from 1 January 2020. By time, probably it will not be secure to use this version on public servers, unless someone still provides security patches for Python 2.
• Some specific parts of the DSP code could be improved for better SNR.

Even though these limitations are probably acceptable in an amateur radio project, I would not build critical infrastructure on it.

For commercial inquiries (e.g. if someone wants me to develop an improved version without these limitations), I'm still open, drop me an e-mail.

---

:floppy_disk: Setup guide for Ubuntu | :blue_book: Knowledge base on the Wiki | :earth_americas: Receivers on SDR.hu

It has the following features:

• csdr based demodulators (AM/FM/SSB/CW/BPSK31),
• 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, HackRF, SDRplay, AirSpy and many other devices, see the OpenWebRX Wiki,
• it has a 3D waterfall display:

News (2015-08-18)

• 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.

News (2016-02-14)

• The DDC in csdr has been manually optimized for ARM NEON, so it runs around 3 times faster on the Raspberry Pi 2 than before.
• Also we use ncat instead of rtl_mus, and it is 3 times faster in some cases.
• OpenWebRX now supports URLs like: http://localhost:8073/#freq=145555000,mod=usb
• UI improvements were made, thanks to John Seamons and Gnoxter.

News (2017-04-04)

• ncat has been replaced with a custom implementation called nmux due to a bug that caused regular crashes on some machines. The nmux tool is part of the csdr package.
• Most consumer SDR devices are supported via rx_tools, see the OpenWebRX Wiki on that.

News (2017-07-12)

• OpenWebRX now has a BPSK31 demodulator and a 3D waterfall display.

When upgrading OpenWebRX, please make sure that you also upgrade csdr!

OpenWebRX servers on SDR.hu

SDR.hu is a site which lists the active, public OpenWebRX servers. Your receiver can also be part of it, if you want.

Setup

OpenWebRX currently requires Linux and python 2.7 to run.

First you will need to install the dependencies:

• libcsdr
• rtl-sdr

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):

• port 4951 for the multi-user I/Q server.

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

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

Usage tips

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).

Setup tips

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.

Licensing

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 licensing options.