mmrelay 1.1.3__py3-none-any.whl → 1.2.0__py3-none-any.whl

mmrelay/plugins/weather_plugin.py

@@ -1,8 +1,10 @@
 import asyncio
+from datetime import datetime
 
 import requests
 from meshtastic.mesh_interface import BROADCAST_NUM
 
+from mmrelay.constants.formats import TEXT_MESSAGE_APP
 from mmrelay.plugins.base_plugin import BasePlugin
 
 
@@ -17,41 +19,114 @@ class Plugin(BasePlugin):
         return "Show weather forecast for a radio node using GPS location"
 
     def generate_forecast(self, latitude, longitude):
+        """
+        Generate a concise one-line weather forecast for the given GPS coordinates.
+
+        Builds and queries the Open-Meteo API for current conditions and hour-aligned forecasts ~+2h and ~+5h, formats temperatures according to the plugin configuration (`self.config["units"]`, default "metric"), and returns a single-line summary including current conditions and the two forecast points.
+
+        Parameters:
+            latitude (float): Latitude in decimal degrees.
+            longitude (float): Longitude in decimal degrees.
+
+        Returns:
+            str: A single-line forecast such as
+                 "Now: ☀️ Clear sky - 12.3°C | +2h: 🌧️ Light rain - 13.1°C 20% | +5h: ⛅️ Partly cloudy - 10.8°C 5%".
+                 On recoverable failures returns a short error message: "Weather data temporarily unavailable.",
+                 "Error fetching weather data.", or "Error parsing weather data.".
+
+        Notes:
+            - Temperature units are determined by `self.config.get("units", "metric")` ("metric" -> °C, "imperial" -> °F).
+            - The function attempts to anchor forecasts to hourly timestamps when available; if timestamps cannot be matched it falls back to hour-of-day indexing (may be less accurate).
+            - Network/HTTP errors and request-related exceptions are handled and result in the "Error fetching weather data." message.
+            - Malformed or incomplete API responses result in "Error parsing weather data." Unexpected exceptions are re-raised.
+        """
         units = self.config.get("units", "metric")  # Default to metric
         temperature_unit = "°C" if units == "metric" else "°F"
 
         url = (
             f"https://api.open-meteo.com/v1/forecast?"
             f"latitude={latitude}&longitude={longitude}&"
-            f"hourly=temperature_2m,precipitation_probability,weathercode,cloudcover&"
-            f"forecast_days=1&current_weather=true"
+            f"hourly=temperature_2m,precipitation_probability,weathercode,is_day&"
+            f"forecast_days=2&timezone=auto&current_weather=true"
         )
 
         try:
             response = requests.get(url, timeout=10)
+            response.raise_for_status()
             data = response.json()
 
             # Extract relevant weather data
             current_temp = data["current_weather"]["temperature"]
             current_weather_code = data["current_weather"]["weathercode"]
             is_day = data["current_weather"]["is_day"]
+            current_time_str = data["current_weather"]["time"]
+
+            # Parse current time to get the hour with defensive handling
+            current_hour = 0
+            current_time = None
+            try:
+                current_time = datetime.fromisoformat(
+                    current_time_str.replace("Z", "+00:00")
+                )
+                current_hour = current_time.hour
+            except ValueError as ex:
+                self.logger.warning(
+                    f"Unexpected current_weather.time '{current_time_str}': {ex}. Defaulting to hour=0."
+                )
+
+            # Calculate indices for +2h and +5h forecasts
+            # Try to anchor to hourly timestamps for robustness, fall back to hour-of-day
+            base_index = current_hour
+            hourly_times = data["hourly"].get("time", [])
+            if hourly_times and current_time:
+                try:
+                    # Normalize current time to the hour and find it in hourly timestamps
+                    base_key = current_time.replace(
+                        minute=0, second=0, microsecond=0
+                    ).strftime("%Y-%m-%dT%H:00")
+                    base_index = hourly_times.index(base_key)
+                except (ValueError, AttributeError):
+                    # Fall back to hour-of-day if hourly timestamps are unavailable/mismatched
+                    self.logger.warning(
+                        "Could not find current time in hourly timestamps. "
+                        "Falling back to hour-of-day indexing, which may be inaccurate."
+                    )
+
+            forecast_2h_index = base_index + 2
+            forecast_5h_index = base_index + 5
 
-            # Get indices for +2h and +5h forecasts
-            # Assuming hourly data starts from current hour
-            forecast_2h_index = 2
-            forecast_5h_index = 5
+            # Guard against empty hourly series before clamping
+            temps = data["hourly"].get("temperature_2m") or []
+            if not temps:
+                self.logger.warning("No hourly temperature data returned.")
+                return "Weather data temporarily unavailable."
+            max_index = len(temps) - 1
+            forecast_2h_index = min(forecast_2h_index, max_index)
+            forecast_5h_index = min(forecast_5h_index, max_index)
 
             forecast_2h_temp = data["hourly"]["temperature_2m"][forecast_2h_index]
             forecast_2h_precipitation = data["hourly"]["precipitation_probability"][
                 forecast_2h_index
             ]
             forecast_2h_weather_code = data["hourly"]["weathercode"][forecast_2h_index]
+            # Get hour-specific day/night flag for +2h forecast
+            forecast_2h_is_day = (
+                data["hourly"]["is_day"][forecast_2h_index]
+                if data["hourly"].get("is_day")
+                else is_day
+            )
 
             forecast_5h_temp = data["hourly"]["temperature_2m"][forecast_5h_index]
             forecast_5h_precipitation = data["hourly"]["precipitation_probability"][
                 forecast_5h_index
             ]
             forecast_5h_weather_code = data["hourly"]["weathercode"][forecast_5h_index]
+            # Get hour-specific day/night flag for +5h forecast
+            forecast_5h_is_day = (
+                data["hourly"]["is_day"][forecast_5h_index]
+                if data["hourly"].get("is_day")
+                else is_day
+            )
 
             if units == "imperial":
                 # Convert temperatures from Celsius to Fahrenheit
@@ -105,27 +180,58 @@ class Plugin(BasePlugin):
                 f"{current_temp}{temperature_unit} | "
             )
             forecast += (
-                f"+2h: {weather_code_to_text(forecast_2h_weather_code, is_day)} - "
+                f"+2h: {weather_code_to_text(forecast_2h_weather_code, forecast_2h_is_day)} - "
                 f"{forecast_2h_temp}{temperature_unit} {forecast_2h_precipitation}% | "
             )
             forecast += (
-                f"+5h: {weather_code_to_text(forecast_5h_weather_code, is_day)} - "
+                f"+5h: {weather_code_to_text(forecast_5h_weather_code, forecast_5h_is_day)} - "
                 f"{forecast_5h_temp}{temperature_unit} {forecast_5h_precipitation}%"
             )
 
             return forecast
 
-        except requests.exceptions.RequestException as e:
-            self.logger.error(f"Error fetching weather data: {e}")
-            return "Error fetching weather data."
+        except Exception as e:
+            # Handle HTTP/network errors from requests
+            # Handle requests-related exceptions using safe attribute checking
+            try:
+                # Check if this is a requests exception by checking the module
+                if hasattr(requests, "RequestException") and isinstance(
+                    e, requests.RequestException
+                ):
+                    self.logger.error(f"Error fetching weather data: {e}")
+                    return "Error fetching weather data."
+            except (AttributeError, TypeError):
+                # Fallback to string-based detection if isinstance fails
+                exception_module = getattr(type(e), "__module__", "")
+                if "requests" in exception_module:
+                    self.logger.error(f"Error fetching weather data: {e}")
+                    return "Error fetching weather data."
+
+            # Handle data parsing errors
+            if isinstance(
+                e, (KeyError, IndexError, TypeError, ValueError, AttributeError)
+            ):
+                self.logger.error(f"Malformed weather data: {e}")
+                return "Error parsing weather data."
+            else:
+                # Re-raise unexpected exceptions
+                raise
 
     async def handle_meshtastic_message(
         self, packet, formatted_message, longname, meshnet_name
     ):
+        """
+        Processes incoming Meshtastic text messages and responds with a weather forecast if the plugin command is detected.
+
+        Checks if the message is a valid text message on the expected port, verifies channel and command enablement, retrieves the sender's GPS location, generates a weather forecast, and sends the response either as a direct message or broadcast depending on the message type.
+
+        Returns:
+            bool: True if the message was handled and a response was sent; False otherwise.
+        """
         if (
             "decoded" in packet
             and "portnum" in packet["decoded"]
-            and packet["decoded"]["portnum"] == "TEXT_MESSAGE_APP"
+            and packet["decoded"]["portnum"] == TEXT_MESSAGE_APP
             and "text" in packet["decoded"]
         ):
             message = packet["decoded"]["text"].strip()

mmrelay/setup_utils.py

@@ -14,6 +14,7 @@ import subprocess
 import sys
 from pathlib import Path
 
+from mmrelay.constants.database import PROGRESS_COMPLETE, PROGRESS_TOTAL_STEPS
 from mmrelay.tools import get_service_template_path
 
 
@@ -54,7 +55,11 @@ def print_service_commands():
 
 
 def wait_for_service_start():
-    """Wait for the service to start with a Rich progress indicator."""
+    """
+    Displays a progress spinner while waiting up to 10 seconds for the mmrelay service to become active.
+
+    The function checks the service status after 5 seconds and completes early if the service is detected as active.
+    """
     import time
 
     from rich.progress import Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
@@ -67,7 +72,7 @@ def wait_for_service_start():
         transient=True,
     ) as progress:
         # Add a task that will run for approximately 10 seconds
-        task = progress.add_task("Starting", total=100)
+        task = progress.add_task("Starting", total=PROGRESS_TOTAL_STEPS)
 
         # Update progress over 10 seconds
         for i in range(10):
@@ -76,7 +81,7 @@ def wait_for_service_start():
 
             # Check if service is active after 5 seconds to potentially finish early
             if i >= 5 and is_service_active():
-                progress.update(task, completed=100)
+                progress.update(task, completed=PROGRESS_COMPLETE)
                 break
 
 
@@ -372,10 +377,11 @@ def check_loginctl_available():
 
 
 def check_lingering_enabled():
-    """Check if user lingering is enabled.
+    """
+    Determine whether user lingering is enabled for the current user.
 
     Returns:
-        bool: True if lingering is enabled, False otherwise.
+        bool: True if user lingering is enabled, False otherwise.
     """
     try:
         username = os.environ.get("USER", os.environ.get("USERNAME"))
@@ -386,7 +392,8 @@ def check_lingering_enabled():
             text=True,
         )
         return result.returncode == 0 and "Linger=yes" in result.stdout
-    except Exception:
+    except Exception as e:
+        print(f"Error checking lingering status: {e}")
         return False
 
 
@@ -417,7 +424,14 @@ def enable_lingering():
 
 
 def install_service():
-    """Install or update the MMRelay user service."""
+    """
+    Install or update the MMRelay systemd user service, guiding the user through creation, updating, enabling, and starting the service as needed.
+
+    Prompts the user for confirmation before updating an existing service file, enabling user lingering, enabling the service to start at boot, and starting or restarting the service. Handles user interruptions gracefully and prints a summary of the service status and management commands upon completion.
+
+    Returns:
+        bool: True if the installation or update process completes successfully, False otherwise.
+    """
     # Check if service already exists
     existing_service = read_service_file()
     service_path = get_user_service_path()
@@ -431,11 +445,14 @@ def install_service():
 
         if update_needed:
             print(f"The service file needs to be updated: {reason}")
-            if (
-                not input("Do you want to update the service file? (y/n): ")
-                .lower()
-                .startswith("y")
-            ):
+            try:
+                user_input = input("Do you want to update the service file? (y/n): ")
+                if not user_input.lower().startswith("y"):
+                    print("Service update cancelled.")
+                    print_service_commands()
+                    return True
+            except (EOFError, KeyboardInterrupt):
+                print("\nInput cancelled. Proceeding with default behavior.")
                 print("Service update cancelled.")
                 print_service_commands()
                 return True
@@ -450,9 +467,11 @@ def install_service():
         if not create_service_file():
             return False
 
-        # Reload daemon
+        # Reload daemon (continue even if this fails)
         if not reload_daemon():
-            return False
+            print(
+                "Warning: Failed to reload systemd daemon. You may need to run 'systemctl --user daemon-reload' manually."
+            )
 
         if existing_service:
             print("Service file updated successfully")
@@ -473,13 +492,16 @@ def install_service():
             print(
                 "Lingering allows user services to run even when you're not logged in."
             )
-            if (
-                input(
+            try:
+                user_input = input(
                     "Do you want to enable lingering for your user? (requires sudo) (y/n): "
                 )
-                .lower()
-                .startswith("y")
-            ):
+                should_enable_lingering = user_input.lower().startswith("y")
+            except (EOFError, KeyboardInterrupt):
+                print("\nInput cancelled. Skipping lingering setup.")
+                should_enable_lingering = False
+
+            if should_enable_lingering:
                 enable_lingering()
 
     # Check if the service is already enabled
@@ -488,11 +510,16 @@ def install_service():
         print("The service is already enabled to start at boot.")
     else:
         print("The service is not currently enabled to start at boot.")
-        if (
-            input("Do you want to enable the service to start at boot? (y/n): ")
-            .lower()
-            .startswith("y")
-        ):
+        try:
+            user_input = input(
+                "Do you want to enable the service to start at boot? (y/n): "
+            )
+            enable_service = user_input.lower().startswith("y")
+        except (EOFError, KeyboardInterrupt):
+            print("\nInput cancelled. Skipping service enable.")
+            enable_service = False
+
+        if enable_service:
             try:
                 subprocess.run(
                     ["/usr/bin/systemctl", "--user", "enable", "mmrelay.service"],
@@ -509,7 +536,14 @@ def install_service():
     service_active = is_service_active()
     if service_active:
         print("The service is already running.")
-        if input("Do you want to restart the service? (y/n): ").lower().startswith("y"):
+        try:
+            user_input = input("Do you want to restart the service? (y/n): ")
+            restart_service = user_input.lower().startswith("y")
+        except (EOFError, KeyboardInterrupt):
+            print("\nInput cancelled. Skipping service restart.")
+            restart_service = False
+
+        if restart_service:
             try:
                 subprocess.run(
                     ["/usr/bin/systemctl", "--user", "restart", "mmrelay.service"],
@@ -526,11 +560,14 @@ def install_service():
                 print(f"Error: {e}")
     else:
         print("The service is not currently running.")
-        if (
-            input("Do you want to start the service now? (y/n): ")
-            .lower()
-            .startswith("y")
-        ):
+        try:
+            user_input = input("Do you want to start the service now? (y/n): ")
+            start_now = user_input.lower().startswith("y")
+        except (EOFError, KeyboardInterrupt):
+            print("\nInput cancelled. Skipping service start.")
+            start_now = False
+
+        if start_now:
             if start_service():
                 # Wait for the service to start
                 wait_for_service_start()

mmrelay/tools/sample-docker-compose-prebuilt.yaml

@@ -0,0 +1,80 @@
+services:
+  mmrelay:
+    image: ghcr.io/jeremiah-k/mmrelay:latest
+    container_name: meshtastic-matrix-relay
+    restart: unless-stopped
+    user: "${UID:-1000}:${GID:-1000}"
+
+    environment:
+      - TZ=UTC
+      - PYTHONUNBUFFERED=1
+      - MPLCONFIGDIR=/tmp/matplotlib
+
+      # Matrix Authentication: Use 'mmrelay auth login' on host system to create credentials.json
+      # The credentials file will be automatically loaded from the volume mount below
+
+      # Meshtastic Connection Settings - Uncomment and configure as needed
+      # TCP Connection (most common)
+      # - MMRELAY_MESHTASTIC_CONNECTION_TYPE=tcp
+      # - MMRELAY_MESHTASTIC_HOST=192.168.1.100
+      # - MMRELAY_MESHTASTIC_PORT=4403  # Default port
+
+      # Serial Connection (uncomment for serial)
+      # - MMRELAY_MESHTASTIC_CONNECTION_TYPE=serial
+      # - MMRELAY_MESHTASTIC_SERIAL_PORT=/dev/ttyUSB0
+
+      # BLE Connection (uncomment for Bluetooth)
+      # - MMRELAY_MESHTASTIC_CONNECTION_TYPE=ble
+      # - MMRELAY_MESHTASTIC_BLE_ADDRESS=AA:BB:CC:DD:EE:FF
+
+      # Meshtastic Operational Settings
+      # - MMRELAY_MESHTASTIC_BROADCAST_ENABLED=true
+      # - MMRELAY_MESHTASTIC_MESHNET_NAME=My Mesh Network
+      # - MMRELAY_MESHTASTIC_MESSAGE_DELAY=2.2  # Minimum 2.0 seconds
+
+      # System Configuration
+      # - MMRELAY_LOGGING_LEVEL=INFO  # DEBUG, INFO, WARNING, ERROR, CRITICAL
+      # - MMRELAY_LOG_FILE=/app/data/logs/mmrelay.log  # Enables file logging
+      # - MMRELAY_DATABASE_PATH=/app/data/meshtastic.sqlite
+
+      # Note: Environment variables for Meshtastic, logging, and database settings take precedence over config.yaml
+
+    volumes:
+      # Map entire ~/.mmrelay directory to /app/data to maintain proper structure
+      # This includes config.yaml, plugins/, data/, logs/, credentials.json, and any other subdirectories
+      # The --data-dir parameter in CMD points to /app/data
+      # Create config.yaml first - see docs/DOCKER.md for setup instructions
+      - ${MMRELAY_HOME}/.mmrelay:/app/data
+
+    # For TCP connections (most common) - Meshtastic typically uses port 4403
+    ports:
+      - 4403:4403
+
+    # For serial connections, uncomment the device you need:
+    # devices:
+    #   - /dev/ttyUSB0:/dev/ttyUSB0
+    #   - /dev/ttyACM0:/dev/ttyACM0
+
+    # For BLE connections, uncomment these:
+    # privileged: true
+    # network_mode: host
+    # Additional volumes for BLE (add to existing volumes section above):
+    #   - /var/run/dbus:/var/run/dbus:ro
+    #   - /sys/bus/usb:/sys/bus/usb:ro
+    #   - /sys/class/bluetooth:/sys/class/bluetooth:ro
+    #   - /sys/devices:/sys/devices:ro
+
+  # Optional: Watchtower for automatic updates
+  # Uncomment this service to enable daily checks for new images
+  # watchtower:
+  #   image: containrrr/watchtower:latest
+  #   container_name: watchtower-mmrelay
+  #   restart: unless-stopped
+  #   volumes:
+  #     - /var/run/docker.sock:/var/run/docker.sock
+  #   environment:
+  #     - WATCHTOWER_CLEANUP=true
+  #     - WATCHTOWER_INCLUDE_STOPPED=true
+  #     - WATCHTOWER_SCHEDULE=0 0 2 * * *  # Daily at 2 AM
+  #     - WATCHTOWER_TIMEOUT=30s
+  #   command: meshtastic-matrix-relay

mmrelay/tools/sample-docker-compose.yaml

@@ -10,15 +10,41 @@ services:
       - PYTHONUNBUFFERED=1
       - MPLCONFIGDIR=/tmp/matplotlib
 
+      # Matrix Authentication: Use 'mmrelay auth login' on host system to create credentials.json
+      # The credentials file will be automatically loaded from the volume mount below
+
+      # Meshtastic Connection Settings - Uncomment and configure as needed
+      # TCP Connection (most common)
+      # - MMRELAY_MESHTASTIC_CONNECTION_TYPE=tcp
+      # - MMRELAY_MESHTASTIC_HOST=192.168.1.100
+      # - MMRELAY_MESHTASTIC_PORT=4403  # Default port
+
+      # Serial Connection (uncomment for serial)
+      # - MMRELAY_MESHTASTIC_CONNECTION_TYPE=serial
+      # - MMRELAY_MESHTASTIC_SERIAL_PORT=/dev/ttyUSB0
+
+      # BLE Connection (uncomment for Bluetooth)
+      # - MMRELAY_MESHTASTIC_CONNECTION_TYPE=ble
+      # - MMRELAY_MESHTASTIC_BLE_ADDRESS=AA:BB:CC:DD:EE:FF
+
+      # Meshtastic Operational Settings
+      # - MMRELAY_MESHTASTIC_BROADCAST_ENABLED=true
+      # - MMRELAY_MESHTASTIC_MESHNET_NAME=My Mesh Network
+      # - MMRELAY_MESHTASTIC_MESSAGE_DELAY=2.2  # Minimum 2.0 seconds
+
+      # System Configuration
+      # - MMRELAY_LOGGING_LEVEL=INFO  # DEBUG, INFO, WARNING, ERROR, CRITICAL
+      # - MMRELAY_LOG_FILE=/app/data/logs/mmrelay.log  # Enables file logging
+      # - MMRELAY_DATABASE_PATH=/app/data/meshtastic.sqlite
+
+      # Note: Environment variables for Meshtastic, logging, and database settings take precedence over config.yaml
+
     volumes:
-      # Configuration - uses standard ~/.mmrelay/config.yaml location
-      # Create this first with: make config
-      - ${MMRELAY_HOME}/.mmrelay/config.yaml:/app/config.yaml:ro
-
-      # Data and logs - same locations as standalone installation
-      # These directories will be created automatically
-      - ${MMRELAY_HOME}/.mmrelay/data:/app/data
-      - ${MMRELAY_HOME}/.mmrelay/logs:/app/logs
+      # Map entire ~/.mmrelay directory to /app/data to maintain proper structure
+      # This includes config.yaml, plugins/, data/, logs/, credentials.json, and any other subdirectories
+      # The --data-dir parameter in CMD points to /app/data
+      # Create config.yaml first with: make config
+      - ${MMRELAY_HOME}/.mmrelay:/app/data
 
     # For TCP connections (most common) - Meshtastic typically uses port 4403
     ports:

mmrelay/tools/sample_config.yaml

@@ -3,6 +3,27 @@ matrix:
   access_token: reaalllllyloooooongsecretttttcodeeeeeeforrrrbot # See: https://t2bot.io/docs/access_tokens/
   bot_user_id: "@botuser:example.matrix.org"
 
+  # Alternative: Automatic credentials creation (Docker-friendly)
+  # If you provide password instead of access_token, MMRelay will automatically
+  # create credentials.json on startup. Useful for Docker deployments.
+  #password: your_matrix_password_here  # Uncomment and set your Matrix password
+
+  # End-to-End Encryption (E2EE) configuration
+  # NOTE: E2EE requires credentials.json instead of access_token for new sessions
+  #
+  # SETUP INSTRUCTIONS:
+  # 1. Install E2EE dependencies: pipx install 'mmrelay[e2e]'
+  # 2. Enable E2EE in config: uncomment and set enabled: true below
+  # 3. Create credentials: mmrelay auth login
+  # 4. The auth login command will create credentials.json with your Matrix login
+  # 5. Restart mmrelay - it will use credentials.json and enable E2EE automatically
+  #
+  #e2ee:
+  #  # Optional: When credentials.json is present, MMRelay auto-enables E2EE.
+  #  # Configure this section only if you want to override defaults (e.g., store_path).
+  #  enabled: false                        # Explicit toggle if you need to force-enable/disable (usually not needed)
+  #  store_path: ~/.mmrelay/store          # Optional path for encryption keys storage
+
   # Message prefix customization (Meshtastic → Matrix direction)
   #prefix_enabled: true # Enable prefixes on messages from mesh (e.g., "[Alice/MyMesh]: message")
   #prefix_format: "[{long}/{mesh}]: " # Default format. Variables: {long1-20}, {long}, {short}, {mesh1-20}, {mesh}
@@ -31,7 +52,7 @@ meshtastic:
   #                                   # Legacy: heartbeat_interval at meshtastic level still supported but deprecated
 
   # Additional configuration options (commented out with defaults)
-  #broadcast_enabled: true # Must be set to true to enable Matrix to Meshtastic messages
+  broadcast_enabled: true # Must be set to true to enable Matrix to Meshtastic messages
   #detection_sensor: true # Must be set to true to forward messages of Meshtastic's detection sensor module
   #message_delay: 2.2 # Delay in seconds between messages sent to mesh (minimum: 2.0 due to firmware)
 
@@ -48,10 +69,14 @@ logging:
   #color_enabled: true                        # Set to false to disable colored console output
 
   # Component-specific debug logging (useful for troubleshooting)
+  # When disabled (false or omitted), external library logs are completely suppressed
+  # When enabled, you can use: true (DEBUG level) or specify level: "debug", "info", "warning", "error"
   #debug:
-  #  matrix_nio: false                         # Enable matrix-nio debug logging for Matrix client issues
-  #  bleak: false                              # Enable BLE (bleak) debug logging for Bluetooth connection issues
-  #  meshtastic: false                         # Enable meshtastic library debug logging for device communication issues
+  #  matrix_nio: false                         # Disable matrix-nio logging (default: completely suppressed)
+  #  #matrix_nio: true                         # Enable matrix-nio debug logging
+  #  #matrix_nio: "warning"                    # Enable matrix-nio warning+ logging
+  #  bleak: false                              # Disable BLE (bleak) logging (default: completely suppressed)
+  #  meshtastic: false                         # Disable meshtastic library logging (default: completely suppressed)
 
 #database:
 #  path: ~/.mmrelay/data/meshtastic.sqlite   # Default location