The BigDish Console program can be found in BigDishTools and provides a general purpose graphical user interface for controlling the antenna. Unlike `srt-py`, this program is intended to run entirely separated from control of the radio system, enabling any desired software to be simultaneously used with the SDR.

Most common operations with the antenna can be accomplished using this program. The primary exception is cases which require realtime communication between the radio and antenna controller. Currently supported features include:

• A map view for terrestrial contesting (clickable to point the antennas)
• A sky overview showing the on-sky pointing locations of the antenna
• Tracking for celestial bodies and arbitrary points in celestial coordinates
• Satellite Tracking
• Running pre-planned antenna control scrips

running the console requires the following python libraries:

• radioconda/digital_rf (we recommend installing the full radioconda environment)
• astropy
• numpy
• scipy
• websockets
• bigdish-client

The entire BigDishTools repository should also be cloned to your preferred location for such things.

The pre-built console program is committed to the github so it should not need to be rebuilt locally.

Launch the console by running:

cd BigDishTools/bigdish_console #change to match you directory structure
python serve.py

This will launch the UI on http://localhost:8620, where it can be displayed in your browser of choice. If a different port is required it can be changed in the config file, or launched with the --port option flag. A path to an alternative configuration file can also be specified with the --config flag.

When you first access the UI in your browser, You will be presented with a prompt to log in to the dish control server.

Note: This program is only intended to run locally and no thought has been given to security. Please do not attempt to expose it on an externally accessible port.

The most common control functions for the antenna are pinned in the sidebar and top bar of the program. These are always displayed. Buttons to go to the preprogrammed service and stow positions and to stop tracking can be found in the top right.

The sidebar contains:

• Dish telemetry and information on running pointing programs
• Pointing options in any of az/el, ra/dec, or galactic coordinates
• Object tracking options
• Tracking offset controls
• A list of other connected users

The map view displays a static polar view of a 250 mile radius circle surrounding the antenna coordinates. The antenna azimuth and elevation are plotted on the map in polar coordinates, along with trajectory overlays for tracked objects.

For amateur radio contests, the locations of known ham stations with microwave capability can be plotted by adding them to the config file. This enables them to be conveniently clicked to write their correct pointing angle to the pointing command fields.

The sky tab shows the antenna pointing position against the sky overhead in several different selectable projections. Uses VirtualSky.

The diagnostics tab slows plots of the dish telemetry for the past hour of program runtime. This includes the motor voltages and currents, antenna positions and velocities, and position and velocity errors.

TODO: These plots are still a little flaky as of 2026/08/22 but mostly work modulo some odd behaviors between tracks. Need to carefully clean up.

The utilities panel is home to a number of additional tools for antenna control. These include functions to:

• Load and queue an antenna pointing command csv
• Load ephemeris files in multiple formats
• Search Celestrak for a satellite and retrieve the latest ephemeris
• Search SIMBAD for named astronomical source coordinates
• Start and stop saving antenna position logs