update docs

Author: semuadmin

CITATION.bib

@@ -2,7 +2,7 @@ @Misc{PyGPSClient
   author       = {{SEMU Consulting}},
   howpublished = {GitHub repository},
   note         = {Viewed last: xxxx:xx:xx},
-  title        = {Python Graphical GPS Client Application supporting NMEA, UBX, RTCM3, NTRIP & SPARTN Protocols},
+  title        = {Python Graphical GPS Client Application supporting NMEA, UBX, SBF, UNI, QGC, RTCM3, NTRIP & SPARTN Protocols},
   year         = {2022},
   url          = {https://github.com/semuconsulting/pygpsclient},
 }

INSTALLATION.md

@@ -61,6 +61,7 @@ The exact location of the site_packages and binary directories will depend on th
 
 In the following, `python3` & `pip` refer to the Python 3 executables. You may need to substitute `python` for `python3`, depending on your particular environment (*on Windows it's generally `python`*). 
 
+- Graphical User Interface (window system / manager)
 - Python >= 3.10⁴
 - Tk (tkinter) >= 8.6⁵ (*tkinter is a commonly used library for developing Graphical User Interfaces (GUI) in Python*)
 - Screen resolution >= 640 x 480 (VGA); Ideally 1920 x 1080, though at lower screen resolutions (<= 1024 width), top level dialogs will be resizable and scrollable.
@@ -224,25 +225,25 @@ pipx will typically create a virtual environment in the user's home folder e.g.
 The following scripts require sudo/admin privileges and will prompt for the sudo password.
 
 ### Debian Linux
-An example [installation shell script](https://github.com/semuconsulting/PyGPSClient/blob/master/examples/pygpsclient_debian_install.sh) is available for use on most vanilla 64-bit Debian-based desktop environments (e.g. Wayland) with Python>=3.10, including Raspberry Pi OS Trixie and Ubuntu LTS. The script...
+An [installation shell script](https://github.com/semuconsulting/PyGPSClient/blob/master/examples/pygpsclient_debian_install.sh) is available for use on most vanilla 64-bit Debian-based desktop environments, including Raspberry Pi OS Trixie and Ubuntu LTS. The script...
 - Installs all necessary Python system libraries.
 - Installs PyGPSClient into a virtual environment in the user's home directory and adds this environment to the user's PATH.
 - Adds user to the relevant /dev/tty* group.
 - Creates a desktop application launcher which can be accessed from the Applications..Other menu.
 
 ```shell
-wget https://raw.githubusercontent.com/semuconsulting/PyGPSClient/refs/heads/master/examples/pygpsclient_debian_install.sh
-# or use curl -O ... if you prefer
+curl -O https://raw.githubusercontent.com/semuconsulting/PyGPSClient/refs/heads/master/examples/pygpsclient_debian_install.sh
+# or use wget ... if you prefer
 chmod +x pygpsclient_debian_install.sh
 ./pygpsclient_debian_install.sh
 ```
 
 ### Arch Linux
-An similar example [installation shell script](https://github.com/semuconsulting/PyGPSClient/blob/master/examples/pygpsclient_arch_install.sh) is available for use on most vanilla 64-bit Arch-based desktop environments (e.g. xfce) with Python>=3.10:
+A similar [installation shell script](https://github.com/semuconsulting/PyGPSClient/blob/master/examples/pygpsclient_arch_install.sh) is available for use on most vanilla 64-bit Arch-based desktop environments (e.g. Xfce / LightDM):
 
 ```shell
-wget https://raw.githubusercontent.com/semuconsulting/PyGPSClient/refs/heads/master/examples/pygpsclient_arch_install.sh
-# or use curl -O ... if you prefer
+curl -O https://raw.githubusercontent.com/semuconsulting/PyGPSClient/refs/heads/master/examples/pygpsclient_arch_install.sh
+# or use wget ... if you prefer
 chmod +x pygpsclient_arch_install.sh
 ./pygpsclient_arch_install.sh
 ```
@@ -251,6 +252,8 @@ chmod +x pygpsclient_arch_install.sh
 A similar [installation shell script](https://github.com/semuconsulting/PyGPSClient/blob/master/examples/pygpsclient_macos_install.sh) is available for MacOS 13 or later running a ZSH shell (*Homebrew or MacPorts are **NOT** required*). This will also install the latest official version of Python 3 with tkinter 8.6. Download the script to your Mac and - from the download folder - type:
 
 ```shell
+curl -O https://raw.githubusercontent.com/semuconsulting/PyGPSClient/refs/heads/master/examples/pygpsclient_macos_install.sh
+chmod +x pygpsclient_macos_install.sh
 ./pygpsclient_macos_install.sh
 ```
 

LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License ("BSD License 2.0", "Revised BSD License", "New BSD License", or "Modified BSD License")
 
-Copyright 2020, semuadmin (Steve Smith)
+Copyright 2020-2026, semuadmin (Steve Smith)
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

README.md

@@ -482,7 +482,7 @@ For further details, refer to the `pygnssutils` homepage at [https://github.com/
 
 [BSD 3-Clause License](https://github.com/semuconsulting/PyGPSClient/blob/master/LICENSE)
 
-Copyright © 2020, semuadmin (Steve Smith)
+Copyright © 2020-2026, semuadmin (Steve Smith)
 
 Application icons from [iconmonstr](https://iconmonstr.com/license/) ©.
 

examples/pygpsclient_arch_install.sh

@@ -25,7 +25,7 @@ echo "PyGPSClient will be installed at $HOME/pygpsclient/bin"
 echo "Installing dependencies..."
 sudo pacman -S tk libspatialite
 
-echo "Setting user permissions..."
+echo "Setting user permissions for /dev/tty* devices..."
 sudo usermod -aG uucp $USER
 
 echo "Creating virtual environment..."
@@ -72,3 +72,4 @@ sed -i '$a# Path to PyGPSClient executable\nexport PATH="${HOME}/pygpsclient/bin
 source $PROF # this will throw an error if running as bash script in zsh shell
 
 echo "Installation complete"
+echo "You may need to restart before accessing /dev/tty*"

examples/pygpsclient_debian_install.sh

@@ -21,19 +21,25 @@ echo "Installed Python version is $PYVER"
 
 echo "PyGPSClient will be installed at $HOME/pygpsclient/bin"
 
-echo "Installing dependencies..."\
-# uncomment any missing dependencies - not normally necessary with RPi OS Trixie
-# sudo apt install python3-pip python3-tk python3-pil python3-pil.imagetk \
-#      libjpeg-dev zlib1g-dev tk-dev python3-rasterio
-     
-echo "Setting user permissions..."
+# Raspberry Pi OS Trixie desktop comes with all the necessary Python dependencies included
+# Ubuntu LTS and a few other Debian desktop distros are missing Python pip, venv, tkinter
+# and PIL libraries
+RELEASE="$(lsb_release -d)"
+echo "Installing dependencies for $RELEASE..."
+if [[ $RELEASE == *"Ubuntu"* ]]; then
+sudo apt install python3-pip python3-venv python3-tk python3-pil python3-pil.imagetk
+sudo apt install libjpeg-dev zlib1g-dev tk-dev python3-rasterio || true
+fi
+
+echo "Setting user permissions for /dev/tty* devices..."
 sudo usermod -a -G dialout $USER
 
 echo "Creating virtual environment..."
 cd $HOME
 python3 -m venv pygpsclient
 source pygpsclient/bin/activate
-python3 -m pip install --upgrade pip pygpsclient rasterio
+python3 -m pip install --upgrade pip pygpsclient
+python3 -m pip install --upgrade rasterio || true
 deactivate
 
 echo "Adding desktop launch icon..."
@@ -73,3 +79,4 @@ sed -i '$a# Path to PyGPSClient executable\nexport PATH="$HOME/pygpsclient/bin:$
 source $PROF # this will throw an error if running as bash script in zsh shell
 
 echo "Installation complete"
+echo "You may need to restart before accessing /dev/tty*"

examples/pygpsclient_macos_install.sh

@@ -17,7 +17,7 @@
 set -e
 
 echo "PyGPSClient will be installed at $HOME/pygpsclient/bin"
-VER=3.14.2
+VER=3.14.3
 echo "Installing Python $VER from python.org ..."
 curl https://www.python.org/ftp/python/$VER/python-$VER-macos11.pkg --output python-$VER-macos11.pkg
 sudo installer -pkg python-$VER-macos11.pkg -target /