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