Skip to main content

PyGPSClient GNSS/GPS Graphical Client

Project description


PyGPSClient is a graphical GNSS/GPS testing and diagnostic client application written entirely in Python and tkinter.

full app screenshot ubx

The application runs on any platform which supports a Python3 interpreter (>=3.6) and tkinter (>=8.6) GUI framework, including Windows, MacOS, Linux and Raspberry Pi OS. It displays location and diagnostic data from any NMEA or UBX (u-blox) compatible GNSS/GPS device over a standard serial (UART) or USB port, or from a previously-saved datalog file, in addition to providing a small but useful subset of the configuration functionality in u-blox's Windows-only u-center tool.

This is an independent project and we have no affiliation whatsoever with u-blox.

Current Status

Status Release Build Release Date Last Commit Contributors Open Issues

Contributions welcome - please refer to CONTRIBUTING.MD.


  1. Supports both NMEA and UBX protocols. It uses the existing pynmea2 library for NMEA parsing and a new pyubx2 library for UBX parsing.
  2. Capable of reading from serial/USB port or previously-saved binary datalog file.
  3. Configurable GUI with selectable and resizeable widgets.
  4. Expandable banner widget showing key navigation information.
  5. Serial console widget showing either raw or parsed data stream.
  6. Skyview widget showing current satellite visibility and position (elevation / azimuth).
  7. Graphview widget showing current satellite reception (signal-to-noise ratio).
  8. Mapview widget with location marker, showing either a static Mercator world map, or an optional dynamic web-based map downloaded via a MapQuest API (requires an Internet connection and free MapQuest API Key).
  9. Data logging.
  10. Track recording in GPX format.
  11. UBX Configuration Dialog, with the ability to send a variety of UBX configuration commands to u-blox GNSS devices. This includes the facility to add user-defined commands or command sequences - see instructions under installation below.

compact view screenshot

How to Use

  • To connect to a listed serial device, select the device from the listbox and click connect icon. The application will endeavour to pre-select a recognised GNSS/GPS device but this is platform and device dependent.
  • To stream from a previously-saved binary datalog file (pygpsdata-*.log, or any binary dump of an NMEA or UBX GNSS device output), click connect-file icon and select the file.
  • To disconnect from a serial device or datalog file, click disconnect icon.
  • To display the UBX Configuration Dialog (only available when connected to a UBX serial device), click gear icon, or go to Menu..Options.
  • To show or hide the various widgets, go to Menu..View and click on the relevant hide/show option.
  • Protocols Displayed - Select which protocols to display (NB: this only changes the displayed protocols - to change the actual protocols output by the receiver, use the CFG-PRT command).
  • Console Display - Change the console display from parsed to raw (hexadecimal) format.
  • Degrees Format and Units - Change the displayed degree and unit formats.
  • Zoom - Change the web map scale (any change will take effect at the next map refresh, indicated by a small timer icon at the top left of the panel).
  • Show Legend - Turn the graph legend on or off.
  • Show Zero Signal - Include or exclude satellites with zero signal level in the graph and sky view panels.
  • Enable Data Logging - Turn Data logging (in binary format) on or off. You will be prompted to select the directory into which timestamped log files are saved.
  • Record Track - Turn track recording (in GPX format) on or off. You will be prompted to select the directory into which timestamped track files are saved.
  • Widgets (and their associated fonts) are fully resizeable.

UBX Configuration Facilities

ubxconfig widget screenshot

The UBX Configuration Dialog currently supports the following UBX configuration 'widgets':

  1. Shows current device hardware/firmware versions via MON-VER and MON-HW polls. Clicking anywhere in the widget background will refresh the displayed information with the current configuration.
  2. CFG-PRT sets baud rate and inbound/outbound protocols across all available ports.
  3. CFG-RATE sets navigation solution interval in ms (e.g. 1000 = 1/second) and measurement ratio (ratio between the number of measurements and the number of navigation solutions, e.g. 5 = five measurements per navigation solution).
  4. CFG-MSG sets message rates per port for UBX and NMEA messages. Message rate is relative to navigation solution frequency e.g. a message rate of '4' means 'every 4th navigation solution'.
  5. CFG-VALSET, CFG-VALDEL and CFG-VALGET configuration (for Generation 9+ devices).
  6. PRESET commands support a variety of preset and user-defined commands - see user defined presets

An icon to the right of each 'SEND' send icon button indicates the confirmation status of the configuration command; (pending i.e. awaiting confirmation pending icon, confirmed confirmed icon or warning warning icon).


  • Confirmation responses can take several seconds at high message transmission rates, or be discarded altogether if the device's transmit buffer is full (txbuff-alloc error). To ensure timely confirmation responses, try increasing the baud rate and/or temporarily reducing transmitted message rates using the configuration commands provided.
  • A warning icon (typically accompanied by an ACK-NAK response) is usually an indication that one or more of the commands sent is not supported by your receiver.


In the following, python & pip refer to the python3 executables. You may need to type python3 or pip3, depending on your particular environment.


See requirements.txt.

On Windows and MacOS, pip, tkinter and the necessary imaging libraries are generally packaged with Python. On some Linux distributions like Ubuntu 18+ and Raspberry Pi OS, they may need to be installed separately, e.g.:

sudo apt-get install python3-pip python3-tk python3-pil python3-pil.imagetk

The following python libraries are required (these will be installed automatically if using pip to install PyGPSClient):

python -m pip install pyubx2 pyserial pynmea2 Pillow requests

User Privileges

To access the serial port on most linux platforms, you will need to be a member of the tty and dialout groups. Other than this, no special privileges are required.

1. Install using pip

Python version PyPI version PyPI downloads

The easiest way to install the latest version of PyGPSClient is with pip:

python -m pip install --upgrade PyGPSClient

If required, PyGPSClient can also be installed using virtualenv, e.g.:

python -m pip install --user --upgrade virtualenv
python -m venv env
source env/bin/activate
(env) python -m pip install --upgrade PyGPSClient

To run the application, if the python3 site_packages are in your PATH, simply type python -m pygpsclient.

If not, type python -m \full_path_to_site_packages\pygpsclient.

Tip: to find the site_packages location, type pip show PyGPSClient and look for the Location: entry in the response, e.g.

  • Linux: Location: /home/username/.local/lib/python3.8/site-packages
  • MacOS: Location: /Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages
  • Windows: Location: c:\users\username\appdata\local\programs\python\python38\lib\site-packages

2. Manual installation

To install manually, download and unzip this repository and run:

python -m /path_to_folder/foldername/pygpsclient

e.g. if you downloaded and unzipped to a folder named PyGPSClient-0.2.0, run:

python -m /path_to_folder/PyGPSClient-0.2.0/pygpsclient

MapQuest API Key

To use the optional dynamic web-based mapview facility, you need to request and install a MapQuest API key. The free edition of this API allows for up to 15,000 transactions/month (roughly 500/day) on a non-commercial basis. For this reason, the map refresh rate is intentionally limited to 1/minute* to avoid exceeding the free transaction limit under normal use. NB: this facility is not intended to be used for real time navigational purposes.

Once you have received the API key (a 32-character alphanumeric string), copy it to a file named mqapikey (lower case, no extension) and place this file in the user's home directory.

*The web map refresh rate can be amended if required by changing the MAP_UPDATE_INTERVAL constant in

User Defined Presets

The UBX Configuration Dialog includes the facility to send user-defined UBX configuration messages or message sequences to the receiver. These can be set up by adding appropriate comma-delimited message descriptions and payload definitions to a file named ubxpresets (lower case, no extension), and then placing this file in the user's home directory. The message definition comprises a free-format text description (avoid embedded commas) followed by one or more pyubx2 UBXMessage constructors, i.e.

  1. message class as a string e.g. CFG (must be a valid class from pyubx2.UBX_CLASSES)
  2. message id as a string e.g. CFG-MSG (must be a valid id from pyubx2.UBX_MSGIDS)
  3. payload as a hexadecimal string e.g. f004010100010100 (leave blank for null payloads e.g. most POLL messages)
  4. mode as an integer (1 = SET, 2 = POLL)

Multiple commands can be concatenated on a single line. Illustrative examples are shown below:

Stop GNSS, CFG, CFG-RST, 00000800, 1
Start GNSS, CFG, CFG-RST, 00000900, 1
Enable NMEA UBX00 & UBX03 sentences (legacy), CFG, CFG-MSG, f100010100010100, 1, CFG, CFG-MSG, f103010100010100, 1
Poll UART1/2 baud rates (modern), CFG, CFG-VALGET, 000000000100524001005340, 2
Poll Message Rates (modern), CFG, CFG-VALGET, 00000000ffff9120, 2, CFG, CFG-VALGET, 00004000ffff9120, 2, CFG, CFG-VALGET, 00008000ffff9120, 2
Use Extended NMEA SV Numbering (modern), CFG, CFG-VALSET, 000000000700932001, 1
Set NAV Solution Rate to 5 Hz (modern), CFG, CFG-VALSET, 0001000001002130c800, 1
Set NAV Solution Rate to 10 Hz (legacy), CFG, CFG-RATE, 640001000000, 1
Poll Receiver Software Version, MON, MON-VER, , 2
Poll Datum, CFG, CFG-DAT, , 2
Poll GNSS config, CFG, CFG-GNSS, , 2
Poll NMEA config, CFG, CFG-NMEA, , 2
Poll Satellite-based Augmentation, CFG, CFG-SBAS, , 2
Poll Receiver Management, CFG, CFG-RXM, , 2
Poll Navigation Mode, CFG, CFG-NAV5, , 2
Poll Expert Navigation mode, CFG, CFG-NAVX5, , 2
Poll Geofencing, CFG, CFG-GEOFENCE, , 2
Limit NMEA GNSS to GPS only (legacy), CFG, CFG-NMEA, 0040000272000000000000010000000000000000, 1
Limit NMEA GNSS to GLONASS only (legacy), CFG, CFG-NMEA, 0040000253000000000000010000000000000000, 1
Set NMEA GNSS to ALL (legacy), CFG, CFG-NMEA, 0040000200000000000000010000000000000000, 1
Limit UBX GNSS to GPS only (legacy), CFG, CFG-GNSS, 0020200700081000010001010101030000000101020408000000010103081000000001010400080000000103050003000000010506080E0000000101, 1
Limit UBX GNSS to GLONASS only (legacy), CFG, CFG-GNSS, 0020200700081000000001010101030000000101020408000000010103081000000001010400080000000103050003000000010506080E0001000101, 1
Set UBX GNSS to ALL (legacy), CFG, CFG-GNSS, 0020200700081000010001010101030001000101020408000000010103081000000001010400080000000103050003000100010506080E0001000101, 1
FORCE COLD RESTART !*** Expect ClearCommError ***!, CFG, CFG-RST, ffff0100, 1

Glossary of Terms



BSD 3-Clause License

Copyright (c) 2020, SEMU Consulting All rights reserved.

Application icons from iconmonstr ©.

Author Information

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for PyGPSClient, version 0.2.27
Filename, size File type Python version Upload date Hashes
Filename, size PyGPSClient-0.2.27-py3-none-any.whl (410.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size PyGPSClient-0.2.27.tar.gz (393.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page