Signal Server GUI is designed as a companion to Signal Server. Signal Server GUI provides a simple and intuitive interface to manage the many configuration options available within Signal Server.
Signal Server GUI is designed as a companion to Signal Server. Signal Server GUI provides a simple and intuitive interface to manage the many configuration options available within Signal Server. This web interface allows you to build and save three item types (Stations, Antennas, and Plots). As you develop plots you are afforded opportunity to manipulate some of the many parameters which can affect propagation. Reasonable default values are provided, which can be changed as you develop and refine your model.
Clone repository
$ git clone https://github.com/thetacom/signalserver_gui
Install external dependencies
Install python dependencies
$ cd signalserver_gui
(No output)
$ python -m venv .venv
(virtual environment creation output)
$ pip install -rrequirements.txt
(pip installation output)
Update required parameters config.ini
Config entries listed below are required.
[signalservergui]
data_dir = data
output_dir = downloads
database_dir = db
[signalserver]
path = /usr/bin/signalserver
[convert]
path = /usr/bin/convert
output_type = png
signalservergui
- Config section with signalservergui settings
data_dir
- Specifies the directory containing various types of data. This option is used to automatically infer the subdirectories for all specific data types.
output_dir
- Specifies the directory into which signalservergui will generate files and make available for download.
database_dir
- Specifies the directory where the sqlite database (signalserver_gui.db) will be created.signalserver
- Config section with signalserver settings
path
- Specifies the path to the signal server binary. Signal Server GUI assumes the signalserverHD and signalserverLIDAR binaries are co-located with the base signalserver binary.
convert
- Config section with convert settings
path
- Specifies the path to the convert binary. Convert is included with the ImageMagick suite of tools.output_type
- Specifies the preferred image format for graphics. Recommend png
to allow image transparency.Starting Signal Server GUI:
$ cd signalserver_gui
(No output)
$ source .venv/bin/activate
(No output)
$ python -m signalserver_gui
(Bottle server console log)...
Listening on http://localhost:8080/
Once signalserver_gui is running, open a browser to the url indicated in the console log.
Example: http://localhost:8080/
Populate database with sample sites and plots.
Caution: Loading test data with re-initialize database and all existing data will be lost.
$ cd signalserver_gui
(No output)
$ source .venv/bin/activate
(No output)
$ python -m db.test_init