joachim
/
openwebrx-clone
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Open source, multi-user SDR receiver software with a web interface
33 Commits 12 Branches 17 Tags 36 MiB
Python 64.4%
JavaScript 24.7%
CSS 4.5%
HTML 3.5%
Shell 2.9%
Go to file
ha7ilm 64e7a411ed fixed named anchor in readme 2015-08-17 20:53:48 +02:00
htdocs label fix 2015-08-17 20:44:05 +02:00
plugins many fixes and new features like IMA ADPCM compression 2015-08-17 20:32:58 +02:00
README.md fixed named anchor in readme 2015-08-17 20:53:48 +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 many fixes and new features like IMA ADPCM compression 2015-08-17 20:32:58 +02:00
openwebrx.py many fixes and new features like IMA ADPCM compression 2015-08-17 20:32:58 +02: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

README.md

OpenWebRX

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

OpenWebRX

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 only supports RTL-SDR, but 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.
  • Auto-update capability for sdr.hu added (currently only sdr.hu beta testers can use it).
  • 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):

  • port 8888 for the I/Q source,
  • 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 (or just have a problem), please drop me a mail:
Andras Retzler, HA7ILM <randras@sdr.hu>

I would like to maintain a list of online amateur radio receivers on openwebrx.org.

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

Configuration tips

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

DSP CPU usage can be fine-tuned in plugins/dsp/csdr/plugin.py: you can set transition bandwidths higher (thus degrade filter performance by decreasing the length of the kernel, but also decrease CPU usage), and also set fft_size lower.

If you constantly get audio overrun errors, you may change audio_buffer_maximal_length_sec in openwebrx.js from the default 1.7 to 3.

If you want a chat-box to the top of the page, here is a snippet for you to include in config_webrx.py.

Todo

Currently, clients use up a lot of bandwidth. This will be improved later.