GlanceRF stores settings in glancerf_config.json in the Project directory. Most options are set in the Setup wizard and the UI—use this page when you need the exact key names, defaults, or environment overrides.
Config keys
| Key |
Type |
Default |
Description |
port |
int |
8080 |
Main server port |
readonly_port |
int |
8081 |
Read-only server port |
desktop_mode |
str |
"browser" |
desktop, browser, terminal, headless, or none |
first_run |
bool |
true |
Redirect to setup when true |
max_grid_scale |
int |
10 |
Max grid columns/rows (1–20) |
grid_columns |
int |
— |
Grid width |
grid_rows |
int |
— |
Grid height |
aspect_ratio |
str |
"16:9" |
Screen aspect ratio |
orientation |
str |
"landscape" |
landscape or portrait |
layout |
list |
— |
2D array of module ids per cell |
cell_spans |
dict |
{} |
Merged cells: "row_col" → {colspan, rowspan} |
module_settings |
dict |
{} |
Per-cell settings: "row_col" → {...} |
setup_callsign |
str |
"" |
Callsign for modules |
setup_location |
str |
"" |
Grid square or lat,lng |
gps_location_enabled |
bool |
false |
Use GPS for system location when on |
gps_time_enabled |
bool |
false |
Use GPS for UTC time when on |
gps_source |
str |
"auto" |
gpsd, serial, or auto (try GPSD then serial) |
gps_serial_port |
str |
"" |
Serial port for direct NMEA (e.g. /dev/ttyUSB0, COM3) |
setup_ssid |
str |
"01" |
APRS SSID |
update_mode |
str |
"auto" |
none, notify, or auto |
update_check_time |
str |
"03:00" |
HH:MM for update check |
telemetry_enabled |
bool |
true |
Telemetry enabled by default (opt-out) |
log_level |
str |
"default" |
default, detailed, verbose, debug |
log_path |
str |
— |
Log file path |
aprs_debug |
bool |
false |
Log each incoming APRS packet to console (very verbose at full feed) |
disable_gpu |
bool |
false |
Disable GPU for WebEngine (Sandbox/VMs) |
gpio_assignments |
dict |
{} |
GPIO pin mappings (Raspberry Pi) |
on_the_air_shortcut |
str |
"" |
Shared shortcut for callsign and On-Air Indicator modules |
Environment Variables
| Variable |
Description |
GLANCERF_CONFIG_PATH |
Override config file path |
GLANCERF_DESKTOP_MODE |
Override desktop_mode |
GLANCERF_PORT |
Override port |
GLANCERF_READONLY_PORT |
Override readonly port |
GLANCERF_DOCKER |
Set when running in Docker (headless) |
GLANCERF_SHOW_CONSOLE |
Force console visible on Windows |
GLANCERF_DISABLE_GPU |
Disable GPU (Sandbox/VMs) |
GLANCERF_PROJECT |
Override project/config directory |
Config Location
- Default:
Project/glancerf_config.json
- Override:
GLANCERF_CONFIG_PATH or GLANCERF_PROJECT
