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

mmrelay/tools/mmrelay.service

@@ -1,5 +1,5 @@
 [Unit]
-Description=A Meshtastic <=> Matrix Relay
+Description=MMRelay - Meshtastic <=> Matrix Relay
 After=network-online.target
 Wants=network-online.target
 
@@ -11,6 +11,7 @@ WorkingDirectory=%h/.mmrelay
 Restart=on-failure
 RestartSec=10
 Environment=PYTHONUNBUFFERED=1
+Environment=LANG=C.UTF-8
 # Ensure both pipx and pip environments are properly loaded
 Environment=PATH=%h/.local/bin:%h/.local/pipx/venvs/mmrelay/bin:/usr/local/bin:/usr/bin:/bin
 

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

@@ -3,78 +3,17 @@ services:
     image: ghcr.io/jeremiah-k/mmrelay:latest
     container_name: meshtastic-matrix-relay
     restart: unless-stopped
+    stop_grace_period: 30s
     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
-
+      - TZ=UTC # Set timezone (PYTHONUNBUFFERED and MPLCONFIGDIR are set in Dockerfile)
     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
+      # Mount your config directory - create ~/.mmrelay/config.yaml first
+      # See docs/DOCKER.md for setup instructions
+      # For SELinux systems (RHEL/CentOS/Fedora), add :Z flag to prevent permission denied errors
+      - ${MMRELAY_HOME:-$HOME}/.mmrelay/config.yaml:/app/config.yaml:ro,Z
+      - ${MMRELAY_HOME:-$HOME}/.mmrelay:/app/data:Z
+      # For non-SELinux systems, you can use:
+      # - ${MMRELAY_HOME:-$HOME}/.mmrelay/config.yaml:/app/config.yaml:ro
+      # - ${MMRELAY_HOME:-$HOME}/.mmrelay:/app/data
+      # Tip: For correct permissions and paths, ensure UID, GID, and MMRELAY_HOME are set in a .env file or exported

mmrelay/tools/sample-docker-compose.yaml

@@ -1,65 +1,19 @@
 services:
   mmrelay:
     build: .
-    container_name: meshtastic-matrix-relay
+    container_name: mmrelay # Updated for consistent branding
     restart: unless-stopped
+    stop_grace_period: 30s
     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
-
+      - TZ=UTC # Set timezone (PYTHONUNBUFFERED and MPLCONFIGDIR are set in Dockerfile)
     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 with: make config
-      - ${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
+      # Mount your config directory - create ~/.mmrelay/config.yaml first
+      # Run 'make config' to set up the files
+      # For SELinux systems (RHEL/CentOS/Fedora), add :Z flag to prevent permission denied errors
+      - ${MMRELAY_HOME:-$HOME}/.mmrelay/config.yaml:/app/config.yaml:ro,Z
+      - ${MMRELAY_HOME:-$HOME}/.mmrelay:/app/data:Z
+      # For non-SELinux systems, you can use:
+      # - ${MMRELAY_HOME:-$HOME}/.mmrelay/config.yaml:/app/config.yaml:ro
+      # - ${MMRELAY_HOME:-$HOME}/.mmrelay:/app/data
+      # Tip: For correct permissions and paths, ensure UID, GID, and MMRELAY_HOME are set in a .env file or exported

mmrelay/tools/sample_config.yaml

@@ -1,22 +1,23 @@
 matrix:
   homeserver: https://example.matrix.org
-  access_token: reaalllllyloooooongsecretttttcodeeeeeeforrrrbot # See: https://t2bot.io/docs/access_tokens/
+  # Modern authentication using password (recommended)
+  # MMRelay will automatically create secure credentials.json on startup
+  password: your_matrix_password_here  # Set your Matrix account password
+  # Security: After first successful start, remove this password from the file.
+  #           Linux/macOS: chmod 600 ~/.mmrelay/config.yaml
+  #           Windows: restrict file access to your user (e.g., via file Properties → Security)
+  #           Never commit this file with a password to version control.
   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
+  # E2EE is automatically enabled when using password-based authentication AND E2EE dependencies are installed (Linux/macOS only)
+  # NOTE: E2EE is not available on Windows due to dependency limitations
   #
   # 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
+  # 1. Install E2EE dependencies: pipx install 'mmrelay[e2e]' (Linux/macOS only)
+  # 2. Set your password above and run MMRelay
+  # 3. MMRelay will automatically create credentials.json with E2EE support
+  # 4. For interactive setup, use: mmrelay auth login
   #
   #e2ee:
   #  # Optional: When credentials.json is present, MMRelay auto-enables E2EE.
@@ -58,7 +59,7 @@ meshtastic:
 
   # Message prefix customization (Matrix → Meshtastic direction)
   #prefix_enabled: true # Enable username prefixes on messages sent to mesh (e.g., "Alice[M]: message")
-  #prefix_format: "{display5}[M]: " # Default format. See EXTRA_CONFIGURATION.md for all variables.
+  #prefix_format: "{display5}[M]: " # Default format. See ADVANCED_CONFIGURATION.md for all variables.
 
 logging:
   level: info

mmrelay/windows_utils.py

@@ -0,0 +1,349 @@
+"""
+Windows-specific utilities for MMRelay.
+
+This module provides Windows-specific functionality and workarounds
+for better compatibility and user experience on Windows systems.
+"""
+
+import os
+import sys
+from typing import Optional
+
+from mmrelay.constants.app import WINDOWS_PLATFORM
+
+
+def is_windows() -> bool:
+    """
+    Return True if the current process is running on a Windows platform.
+
+    Checks common platform indicators (os.name == "nt" or sys.platform == WINDOWS_PLATFORM)
+    and returns a boolean accordingly.
+
+    Returns:
+        bool: True when running on Windows, otherwise False.
+    """
+    return os.name == "nt" or sys.platform == WINDOWS_PLATFORM
+
+
+def setup_windows_console() -> None:
+    """
+    Configure the Windows console for UTF-8 output and ANSI (VT100) color support.
+    
+    Best-effort operation: on Windows this attempts to set stdout/stderr encoding to UTF-8
+    (if supported) and enable Virtual Terminal Processing so ANSI color sequences and
+    Unicode render correctly. No-op on non-Windows platforms; failures are silently ignored.
+    """
+    if not is_windows():
+        return
+
+    try:
+        # Enable UTF-8 output on Windows
+        if hasattr(sys.stdout, "reconfigure"):
+            sys.stdout.reconfigure(encoding="utf-8")
+        if hasattr(sys.stderr, "reconfigure"):
+            sys.stderr.reconfigure(encoding="utf-8")
+
+        # Enable ANSI color codes on Windows 10+
+        import ctypes
+
+        kernel32 = ctypes.windll.kernel32
+        ENABLE_VTP = 0x0004  # ENABLE_VIRTUAL_TERMINAL_PROCESSING
+        for handle in (-11, -12):  # STD_OUTPUT_HANDLE, STD_ERROR_HANDLE
+            h = kernel32.GetStdHandle(handle)
+            if h is not None and h != -1:
+                mode = ctypes.c_uint()
+                if kernel32.GetConsoleMode(h, ctypes.byref(mode)):
+                    kernel32.SetConsoleMode(h, mode.value | ENABLE_VTP)
+    except (OSError, AttributeError):
+        # If console setup fails, continue without it
+        # This is expected on non-Windows systems or older Windows versions
+        return
+
+
+def get_windows_error_message(error: Exception) -> str:
+    """
+    Return a Windows-tailored, user-friendly message for common filesystem and network exceptions.
+
+    If not running on Windows this returns str(error) unchanged. For Windows, the function recognizes
+    permission errors (PermissionError or OSError with EACCES/EPERM), missing-file errors
+    (FileNotFoundError or OSError with ENOENT), and common network-related OSErrors
+    (EHOSTUNREACH, ENETDOWN, ENETUNREACH, ECONNREFUSED, ETIMEDOUT) and returns guidance specific
+    to each case (possible causes and suggested next steps). For other exceptions it returns
+    str(error).
+
+    Parameters:
+        error (Exception): The exception to translate into a user-facing message.
+
+    Returns:
+        str: A user-oriented error message; either a Windows-specific guidance string or the
+        original exception string for unhandled cases or non-Windows platforms.
+    """
+    if not is_windows():
+        return str(error)
+
+    import errno as _errno
+
+    # Use exception types and errno codes for more robust error detection
+    if isinstance(error, PermissionError) or (
+        isinstance(error, OSError) and error.errno in {_errno.EACCES, _errno.EPERM}
+    ):
+        return (
+            f"Permission denied: {error}\n"
+            "This may be caused by:\n"
+            "• Antivirus software blocking the operation\n"
+            "• Windows User Account Control (UAC) restrictions\n"
+            "• File being used by another process\n"
+            "Try running as administrator or check antivirus settings."
+        )
+    elif isinstance(error, FileNotFoundError) or (
+        isinstance(error, OSError) and error.errno in {_errno.ENOENT}
+    ):
+        return (
+            f"File not found: {error}\n"
+            "This may be caused by:\n"
+            "• Incorrect file path (check for spaces or special characters)\n"
+            "• File moved or deleted by antivirus software\n"
+            "• Network drive disconnection\n"
+            "Verify the file path and check antivirus quarantine."
+        )
+    elif isinstance(error, ConnectionError) or (
+        isinstance(error, OSError)
+        and error.errno
+        in {
+            _errno.EHOSTUNREACH,
+            _errno.ENETDOWN,
+            _errno.ENETUNREACH,
+            _errno.ECONNREFUSED,
+            _errno.ETIMEDOUT,
+        }
+    ):
+        return (
+            f"Network error: {error}\n"
+            "This may be caused by:\n"
+            "• Windows Firewall blocking the connection\n"
+            "• Antivirus software blocking network access\n"
+            "• VPN or proxy configuration issues\n"
+            "Check firewall settings and antivirus network protection."
+        )
+    else:
+        return str(error)
+
+
+def check_windows_requirements() -> Optional[str]:
+    """
+    Return a multi-line warning string when common Windows environment issues are detected; otherwise None.
+
+    Performs Windows-only checks:
+    - Python version: warns if running on Python < 3.9.
+    - Virtual environment: warns if the process does not appear to be inside a venv/pipx.
+    - Current working directory length: warns if the cwd path length exceeds 200 characters.
+
+    Returns:
+        Optional[str]: A human-readable, multi-line warning message when one or more checks trigger;
+        returns None if running on a non-Windows platform or no issues are found.
+    """
+    if not is_windows():
+        return None
+
+    warnings = []
+
+    # Check Python version for Windows compatibility
+    if sys.version_info < (3, 9):
+        warnings.append(
+            "Python 3.9+ is recommended on Windows for better compatibility"
+        )
+
+    # Check if running in a virtual environment
+    if not hasattr(sys, "real_prefix") and not (
+        hasattr(sys, "base_prefix") and sys.base_prefix != sys.prefix
+    ):
+        warnings.append(
+            "Consider using a virtual environment (venv) or pipx for better isolation"
+        )
+
+    # Check for common Windows path issues
+    if len(os.getcwd()) > 200:
+        warnings.append(
+            "Current directory path is very long - this may cause issues on Windows"
+        )
+
+    if warnings:
+        return "Windows compatibility warnings:\n• " + "\n• ".join(warnings)
+
+    return None
+
+
+def test_config_generation_windows(args=None) -> dict:
+    """
+    Run Windows-only diagnostics for MMRelay configuration generation.
+
+    Performs four checks and returns a dictionary with per-test results and an overall status:
+    - sample_config_path: verifies mmrelay.tools.get_sample_config_path() exists.
+    - importlib_resources: attempts to read mmrelay.tools/sample_config.yaml via importlib.resources.
+    - config_paths: calls mmrelay.config.get_config_paths(args) and reports the returned paths.
+    - directory_creation: ensures parent directories for the config paths exist (creates them if missing).
+
+    Parameters:
+        args (optional): Forwarded to mmrelay.config.get_config_paths; typically CLI-style arguments or None.
+
+    Returns:
+        dict: Diagnostic results with these keys:
+            - sample_config_path, importlib_resources, config_paths, directory_creation:
+                dict objects with "status" ("ok" or "error") and "details" (string).
+            - overall_status: one of "ok" (no errors), "partial" (1–2 errors), or "error" (3+ errors).
+        If called on a non-Windows platform, returns {"error": "This function is only for Windows systems"}.
+
+    Notes:
+        - The function does not raise on expected failures; errors are reported in the returned dict.
+        - Directory creation test may create directories on disk when missing.
+    """
+    if not is_windows():
+        return {"error": "This function is only for Windows systems"}
+
+    results = {
+        "sample_config_path": {"status": "unknown", "details": ""},
+        "importlib_resources": {"status": "unknown", "details": ""},
+        "config_paths": {"status": "unknown", "details": ""},
+        "directory_creation": {"status": "unknown", "details": ""},
+        "overall_status": "unknown",
+    }
+
+    try:
+        # Test 1: Sample config path
+        try:
+            from mmrelay.tools import get_sample_config_path
+
+            sample_path = get_sample_config_path()
+            if os.path.exists(sample_path):
+                results["sample_config_path"] = {
+                    "status": "ok",
+                    "details": f"Found at: {sample_path}",
+                }
+            else:
+                results["sample_config_path"] = {
+                    "status": "error",
+                    "details": f"Not found at: {sample_path}",
+                }
+        except (
+            ImportError,
+            OSError,
+            FileNotFoundError,
+            AttributeError,
+            TypeError,
+        ) as e:
+            results["sample_config_path"] = {"status": "error", "details": str(e)}
+
+        # Test 2: importlib.resources fallback
+        try:
+            import importlib.resources
+
+            content = (
+                importlib.resources.files("mmrelay.tools")
+                .joinpath("sample_config.yaml")
+                .read_text()
+            )
+            results["importlib_resources"] = {
+                "status": "ok",
+                "details": f"Content length: {len(content)} chars",
+            }
+        except (ImportError, OSError, FileNotFoundError) as e:
+            results["importlib_resources"] = {"status": "error", "details": str(e)}
+
+        # Test 3: Config paths
+        try:
+            from mmrelay.config import get_config_paths
+
+            paths = get_config_paths(args)
+            results["config_paths"] = {"status": "ok", "details": f"Paths: {paths}"}
+        except (ImportError, OSError) as e:
+            results["config_paths"] = {"status": "error", "details": str(e)}
+
+        # Test 4: Directory creation
+        try:
+            from mmrelay.config import get_config_paths
+
+            paths = get_config_paths(args)
+            created_dirs = []
+            for path in paths:
+                dir_path = os.path.dirname(path)
+                if not os.path.exists(dir_path):
+                    os.makedirs(dir_path, exist_ok=True)
+                    created_dirs.append(dir_path)
+            results["directory_creation"] = {
+                "status": "ok",
+                "details": f"Created: {created_dirs}",
+            }
+        except OSError as e:
+            results["directory_creation"] = {"status": "error", "details": str(e)}
+
+        # Determine overall status
+        error_count = sum(
+            1
+            for r in results.values()
+            if isinstance(r, dict) and r.get("status") == "error"
+        )
+        if error_count == 0:
+            results["overall_status"] = "ok"
+        elif error_count < 3:  # If at least one fallback works
+            results["overall_status"] = "partial"
+        else:
+            results["overall_status"] = "error"
+
+    except OSError as e:
+        results["overall_status"] = "error"
+        results["error"] = str(e)
+
+    return results
+
+
+def get_windows_install_guidance() -> str:
+    """
+    Return a Windows-specific installation and troubleshooting guide as a formatted string.
+
+    The returned text contains recommended installation methods, common Windows-specific problems with actionable remedies, and troubleshooting tips for configuration and runtime issues. It is safe to display directly to end users or include in logs/help output.
+
+    Returns:
+        str: Multiline guidance text suited for Windows users.
+    """
+    return """
+Windows Installation & Troubleshooting Guide:
+
+📦 Recommended Installation:
+   pipx install mmrelay
+   (pipx provides better isolation and fewer conflicts)
+
+🔧 If pipx is not available:
+   pip install --user mmrelay
+   (installs to user directory, avoiding system conflicts)
+
+⚠️  Common Windows Issues:
+
+1. "ModuleNotFoundError: No module named 'pkg_resources'"
+   Solution: pip install --upgrade setuptools
+   Alternative: Use 'python -m mmrelay' instead of 'mmrelay'
+
+2. "Access denied" or permission errors
+   Solution: Run command prompt as administrator
+   Or: Use --user flag with pip
+
+3. "SSL certificate verify failed"
+   Solution: Update certificates or use --trusted-host flag
+
+4. Antivirus blocking installation/execution
+   Solution: Add Python and pip to antivirus exclusions
+
+5. Long path issues
+   Solution: Enable long path support in Windows 10+
+   Or: Use shorter installation directory
+
+6. Config generation fails
+   Solution: Check if sample_config.yaml is accessible
+   Alternative: Manually create config file from documentation
+
+🆘 Need Help?
+   • Check Windows Event Viewer for detailed error logs
+   • Temporarily disable antivirus for testing
+   • Use Windows PowerShell instead of Command Prompt
+   • Consider using Windows Subsystem for Linux (WSL)
+   • Test config generation: 'python -m mmrelay config diagnose'
+"""

{mmrelay-1.2.0.dist-info → mmrelay-1.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mmrelay
-Version: 1.2.0
+Version: 1.2.2
 Summary: Bridge between Meshtastic mesh networks and Matrix chat rooms
 Home-page: https://github.com/jeremiah-k/meshtastic-matrix-relay
 Author: Geoff Whittington, Jeremiah K., and contributors
@@ -22,16 +22,16 @@ Requires-Dist: meshtastic>=2.6.4
 Requires-Dist: Pillow==11.3.0
 Requires-Dist: matrix-nio==0.25.2
 Requires-Dist: matplotlib==3.10.1
-Requires-Dist: requests==2.32.4
-Requires-Dist: markdown==3.8.2
+Requires-Dist: requests==2.32.5
+Requires-Dist: markdown==3.9
 Requires-Dist: bleach==6.2.0
 Requires-Dist: haversine==2.9.0
 Requires-Dist: schedule==1.2.2
-Requires-Dist: platformdirs==4.3.8
+Requires-Dist: platformdirs==4.4.0
 Requires-Dist: py-staticmaps>=0.4.0
 Requires-Dist: psutil>=5.8.0
 Requires-Dist: rich==14.1.0
-Requires-Dist: setuptools==80.9.0
+Requires-Dist: setuptools>=80.9.0
 Provides-Extra: e2e
 Requires-Dist: matrix-nio[e2e]==0.25.2; extra == "e2e"
 Requires-Dist: python-olm; extra == "e2e"
@@ -48,7 +48,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# M<>M Relay
+# MMRelay
 
 ## (Meshtastic <=> Matrix Relay)
 
@@ -69,22 +69,22 @@ A powerful and easy-to-use relay between Meshtastic devices and Matrix chat room
 - ✨️ _Native Docker support_ ✨️
 - 🔐 **Matrix End-to-End Encryption (E2EE) support** 🔐 **NEW in v1.2!**
 
-**MMRelay v1.2** introduces full **Matrix End-to-End Encryption** support for secure communication in encrypted rooms. Messages are automatically encrypted/decrypted when communicating with encrypted Matrix rooms, with simple setup using `mmrelay auth login` or automatic credentials creation from config.yaml.
+**MMRelay v1.2** introduces **Matrix End-to-End Encryption** support for secure communication in encrypted rooms. Messages are automatically encrypted/decrypted when communicating with encrypted Matrix rooms, with simple setup using `mmrelay auth login` or automatic credentials creation from config.yaml.
 
 ## Documentation
 
-Visit our [Wiki](https://github.com/jeremiah-k/meshtastic-matrix-relay/wiki) for comprehensive guides and information.
-
 MMRelay supports multiple deployment methods including Docker, pip installation, and standalone executables. For complete setup instructions and all deployment options, see:
 
 - [Installation Instructions](docs/INSTRUCTIONS.md) - Setup and configuration guide
 - [Docker Guide](docs/DOCKER.md) - Docker deployment methods
+- [What's New in v1.2](docs/WHATS_NEW_1.2.md) - New features and improvements
+- [E2EE Setup Guide](docs/E2EE.md) - Matrix End-to-End Encryption configuration
 
 ---
 
 ## Plugins
 
-M<>M Relay supports plugins for extending its functionality, enabling customization and enhancement of the relay to suit specific needs.
+MMRelay supports plugins for extending its functionality, enabling customization and enhancement of the relay to suit specific needs.
 
 ### Core Plugins
 
@@ -133,7 +133,7 @@ Plugins make it easy to extend functionality without modifying the core program.
 
 ## Getting Started with Matrix
 
-See our Wiki page [Getting Started With Matrix & MM Relay](https://github.com/jeremiah-k/meshtastic-matrix-relay/wiki/Getting-Started-With-Matrix-&-MM-Relay).
+See our Wiki page [Getting Started With Matrix & MMRelay](https://github.com/jeremiah-k/meshtastic-matrix-relay/wiki/Getting-Started-With-Matrix-&-MM-Relay).
 
 ---