GrWebSDR is a web SDR receiver.

On Fedora (tested on F25), you will need the following packages:

• gnuradio-devel
• boost-devel
• libvorbis-devel
• libogg-devel
• libwebsockets-devel
• json-c-devel
• gr-osmosdr-devel
• openssl-devel
• sqlite-devel (version 3)

$ autoreconf --install
$ ./configure
$ make

$ cd src/cpp
$ ./grwebsdr

You will be asked to enter some parameters for your tuner. If you don't want to fill in the parameters each time you run the server, you can create a configuration file (see the file sample_config.json) and run it as

$ ./grwebsdr -f <config file>

You will also be asked to enter a new admin user name + password for the web UI.

Now visit http://localhost:8080/ in your browser.

For more options see the output of

$ ./grwebsdr -h

If you don't want to type in the admin credentials each time you run GrWebSDR, or if you want to have more than one privileged user, you can create a user database. GrWebSDR uses sqlite3 as the database backend.

To create a new user database and add a new user 'admin' with password 'secret', do the following:

$ sqlite3 users.db
SQLite version 3.14.2 2016-09-12 18:50:49
Enter ".help" for usage hints.
sqlite> CREATE TABLE users(user VARCHAR, pass);
sqlite> INSERT INTO users VALUES ('admin', 'secret');
sqlite> .quit

You can now pass the created database file to GrWebSDR using the '-d' option.

Managing the database through GrWebSDR itself is planned, but not yet implemented.

1. When using a RTL-SDR tuner then sometimes upon loading the web UI, or when changing some receiver parameter, the server hangs, printing 'O' characters to stderr. This is caused by a race condition originating in rtl-sdr and gr-osmosdr. A patch for rtl-sdr is available from https://pastebin.com/5ykfNvdp (SHA-1: 9e8f0bc2d4955b9a86003ecf88d51c0021aa5a9d), and for gr-osmosdr from https://pastebin.com/SCPGBGWe (SHA-1: e4c0fc1b1051d5211f02bd81d7c840e2bcc04f7b). The fix isn't complete, but it mostly works. Note that the patch for rtl-sdr adds a new API call, which the gr-osmosdr patch uses, so you'll need to build rtl-sdr first.

Copyright (C) 2017 Ondřej Lysoněk

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see the file COPYING). If not, see http://www.gnu.org/licenses/.