update linux installation scripts

Author: semuadmin

INSTALLATION.md

@@ -96,7 +96,7 @@ Note that on MacOS, serial ports may appear as `/dev/tty*` *or* `/dev/cu*`. To u
 
 ### Linux (including Raspberry Pi OS)
 
-Some Linux distributions may not include the necessary pip, venv, tkinter, Pillow or spatialite libraries by default. They may need to be installed separately, e.g. for Debian-based distibutions, a combination of some or all of the following:
+Some older Linux distributions may not include all the necessary pip, venv, tkinter, Pillow or spatialite libraries by default e.g. for Debian-based distibutions, a combination of some or all of the following:
 
 ```shell
 sudo apt install python3-pip python3-tk python3-pil python3-venv python3-pil.imagetk libjpeg-dev zlib1g-dev tk-dev libspatialite
@@ -224,17 +224,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 environments with Python>=3.10, including Raspberry Pi and Ubuntu. To run this installation script, download it to your Raspberry Pi or other Debian-based workstation and - from the download folder - type:
+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...
+- 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
 chmod +x pygpsclient_debian_install.sh
 ./pygpsclient_debian_install.sh
 ```
 
 ### Arch Linux
-An 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 environments with Python>=3.10. To run this installation script, download it to your Arch-based workstation and - from the download folder - type:
+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:
 
 ```shell
+wget https://raw.githubusercontent.com/semuconsulting/PyGPSClient/refs/heads/master/examples/pygpsclient_arch_install.sh
+# or use curl -O ... if you prefer
 chmod +x pygpsclient_arch_install.sh
 ./pygpsclient_arch_install.sh
 ```

examples/pygpsclient_debian_install.sh

@@ -1,10 +1,9 @@
 #!/bin/bash
 
-# Bash shell script to install PyGPSClient on 64-bit Debian-based
-# Linux environments, including Raspberry Pi and Ubuntu.
+# Bash shell script to install PyGPSClient on Raspberry Pi OS (Trixie) or any other
+# up-to-date 64-bit Debian-based Linux desktop environment.
 #
 # Change shebang /bin/bash to /bin/zsh if running from zsh shell.
-# NB: NOT for use on Windows or MacOS!
 #
 # Remember to run chmod +x pygpsclient_debian_install.sh to make this script executable.
 #
@@ -22,24 +21,26 @@ echo "Installed Python version is $PYVER"
 
 echo "PyGPSClient will be installed at $HOME/pygpsclient/bin"
 
-echo "Installing dependencies..."
-sudo apt install python3-pip python3-tk python3-pil python3-pil.imagetk \
-     libjpeg-dev zlib1g-dev tk-dev python3-rasterio
+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..."
-sudo usermod -a -G tty $USER
+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
+python3 -m pip install --upgrade pip pygpsclient rasterio
 deactivate
 
 echo "Adding desktop launch icon..."
 # the LD_LIBRARY_PATH env setting allows PyGPSClient to find the 
 # mod_spatialite.so module, which is typically installed in this location
 # you can set other env variables in a similar fashion if required
+mkdir -p $HOME/.local/share/applications
 cat > $HOME/.local/share/applications/pygpsclient.desktop <<EOF
 [Desktop Entry]
 Type=Application