2014-11-29 00:07:10 +00:00
OpenWebRX
2014-11-28 20:55:31 +00:00
=========
2014-11-29 00:07:10 +00:00
OpenWebRX is a multi-user SDR receiver software with a web interface.
2014-11-29 17:47:50 +00:00
2014-11-29 00:07:10 +00:00
It has the following features:
- < a href = "https://github.com/simonyiszk/csdr" > libcsdr</ a > based demodulators (AM/FM/SSB),
2014-11-29 00:10:36 +00:00
- filter passband can be set from GUI,
2014-11-29 00:07:10 +00:00
- waterfall display can be shifted back in time,
2014-11-29 00:10:36 +00:00
- it extensively uses HTML5 features like WebSocket, Web Audio API, and < canvas> .
2014-11-29 00:07:10 +00:00
- it works in Google Chrome, Chromium (above version 37) and Mozilla Firefox (above version 28),
2015-10-11 00:09:49 +00:00
- currently supports RTL-SDR and HackRF; other SDR hardware may be easily added.
2014-11-29 00:07:10 +00:00
2015-09-30 14:06:30 +00:00
**News (2015-08-18)**
2015-08-17 18:32:58 +00:00
- My BSc. thesis written on OpenWebRX is < a href = "http://openwebrx.org/bsc-thesis.pdf" > available here.</ a >
- 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` .)
2015-08-17 18:53:48 +00:00
- OpenWebRX now uses < a href = "https://github.com/simonyiszk/csdr#sdrjs" > sdr.js</ a > (*libcsdr* compiled to JavaScript) for some client-side DSP tasks.
2016-02-14 17:54:18 +00:00
- Receivers can now be listed on < a href = "http://sdr.hu/" > SDR.hu</ a > .
2015-08-17 18:32:58 +00:00
- License for OpenWebRX is now Affero GPL v3.
2016-02-14 18:35:39 +00:00
**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.
2016-02-14 18:36:18 +00:00
- Also we use *ncat* instead of *rtl_mus* , and it is 3 times faster in some cases.
2016-02-14 17:53:06 +00:00
- OpenWebRX now supports URLs like: `http://localhost:8073/#freq=145555000,mod=usb`
2016-02-14 17:51:22 +00:00
- UI improvements were made, thanks to John Seamons and Gnoxter.
2015-09-30 14:06:30 +00:00
2017-04-04 16:15:08 +00:00
**News (2017-04-04)**
2017-04-04 16:16:20 +00:00
- *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.
2017-04-04 16:15:08 +00:00
- Most consumer SDR devices are supported via < a href = "https://github.com/rxseger/rx_tools" > rx_tools</ a > , see the < a href = "https://github.com/simonyiszk/openwebrx/wiki/Using-rx_tools-with-OpenWebRX" > OpenWebRX Wiki</ a > on that.
2016-02-14 18:36:49 +00:00
> When upgrading OpenWebRX, please make sure that you also upgrade *csdr*, and install the new dependency, *ncat*!
2016-01-23 23:03:08 +00:00
2016-02-14 17:53:48 +00:00
## OpenWebRX servers on SDR.hu
2016-02-14 17:23:34 +00:00
2016-02-14 17:53:48 +00:00
[SDR.hu ](http://sdr.hu ) is a site which lists the active, public OpenWebRX servers. Your receiver [can also be part of it ](http://sdr.hu/openwebrx ), if you want.
2016-02-14 17:19:32 +00:00
2015-09-30 14:06:30 +00:00
2014-11-29 00:07:10 +00:00
## Setup
2014-11-29 17:50:25 +00:00
OpenWebRX currently requires Linux and python 2.7 to run.
2014-11-29 00:07:10 +00:00
First you will need to install the dependencies:
2014-11-29 00:07:47 +00:00
2014-11-29 00:07:10 +00:00
- < a href = "https://github.com/simonyiszk/csdr" > libcsdr</ a >
- < a href = "http://sdr.osmocom.org/trac/wiki/rtl-sdr" > rtl-sdr</ a >
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 < a href = "http://localhost:8073" > http://localhost:8073< / a > .
2014-11-29 00:12:17 +00:00
Please note that the server is also listening on the following ports (on localhost only):
2014-11-29 00:07:47 +00:00
2014-11-29 00:07:10 +00:00
- 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` .
2017-04-04 16:15:08 +00:00
Actually, if you do something cool with OpenWebRX, please drop me a mail:
2014-11-29 00:13:38 +00:00
*Andras Retzler, HA7ILM < randras@sdr.hu> *
2014-11-29 00:13:15 +00:00
2014-11-29 00:07:10 +00:00
## Usage tips
2014-11-29 13:09:03 +00:00
You can zoom the waterfall display by the mouse wheel. You can also drag the waterfall to pan across it.
2014-11-29 13:05:39 +00:00
2014-11-29 00:07:47 +00:00
The filter envelope can be dragged at its ends and moved around to set the passband.
2014-11-29 00:07:10 +00:00
2014-11-29 13:09:03 +00:00
However, if you hold down the shift key, you can drag the center line (BFO) or the whole passband (PBS).
2014-11-29 00:07:47 +00:00
2015-10-11 16:50:12 +00:00
## Setup tips
2014-11-29 12:56:56 +00:00
2015-10-11 16:52:45 +00:00
If you have any problems installing OpenWebRX, you should check out the < a href = "https://github.com/simonyiszk/openwebrx/wiki" > Wiki< / a > about it, which has a page on the < a href = "https://github.com/simonyiszk/openwebrx/wiki/Common-problems-and-their-solutions" > common problems and their solutions< / a > .
2014-11-29 12:56:56 +00:00
2015-10-11 16:51:37 +00:00
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.
2014-11-30 17:00:53 +00:00
2016-02-14 18:28:06 +00:00
If you want to run OpenWebRX on a remote server instead of *localhost* , do not forget to set *server_hostname* in `config_webrx.py` .
2015-11-29 16:55:45 +00:00
## Licensing
2015-11-29 16:59:12 +00:00
OpenWebRX is available under Affero GPL v3 license (< a href = "https://tldrlegal.com/license/gnu-affero-general-public-license-v3-(agpl-3.0)" > summary< / a > ).
2015-11-29 16:55:45 +00:00
2017-04-04 16:15:08 +00:00
OpenWebRX is also available under a commercial license on request. Please contact me at the address *<randras@sdr.hu>* for licensing options.
