mmrelay 1.0.6__py3-none-any.whl → 1.0.8__py3-none-any.whl

mmrelay/__init__.py

@@ -15,4 +15,4 @@ else:
         __version__ = pkg_resources.get_distribution("mmrelay").version
     except pkg_resources.DistributionNotFound:
         # If all else fails, use hardcoded version
-        __version__ = "1.0.1"
+        __version__ = "1.0.8"

mmrelay/cli.py

@@ -3,6 +3,7 @@ Command-line interface handling for the Meshtastic Matrix Relay.
 """
 
 import argparse
+import importlib.resources
 import os
 import sys
 
@@ -11,6 +12,7 @@ from yaml.loader import SafeLoader
 
 # Import version from package
 from mmrelay import __version__
+from mmrelay.tools import get_sample_config_path
 
 
 def parse_arguments():
@@ -363,29 +365,65 @@ def generate_sample_config():
     # Ensure the directory exists
     os.makedirs(os.path.dirname(target_path), exist_ok=True)
 
-    # Try to find the sample config file
-    # First, check in the package directory
-    package_dir = os.path.dirname(__file__)
-    sample_config_path = os.path.join(
-        os.path.dirname(os.path.dirname(package_dir)), "sample_config.yaml"
-    )
+    # Use the helper function to get the sample config path
+    sample_config_path = get_sample_config_path()
 
-    # If not found, try the repository root
-    if not os.path.exists(sample_config_path):
-        repo_root = os.path.dirname(os.path.dirname(__file__))
-        sample_config_path = os.path.join(repo_root, "sample_config.yaml")
+    if os.path.exists(sample_config_path):
+        # Copy the sample config file to the target path
+        import shutil
 
-    # If still not found, try the current directory
-    if not os.path.exists(sample_config_path):
-        sample_config_path = os.path.join(os.getcwd(), "sample_config.yaml")
+        shutil.copy2(sample_config_path, target_path)
+        print(f"Generated sample config file at: {target_path}")
+        print(
+            "\nEdit this file with your Matrix and Meshtastic settings before running mmrelay."
+        )
+        return True
+
+    # If the helper function failed, try using importlib.resources directly
+    try:
+        # Try to get the sample config from the package resources
+        sample_config_content = (
+            importlib.resources.files("mmrelay.tools")
+            .joinpath("sample_config.yaml")
+            .read_text()
+        )
+
+        # Write the sample config to the target path
+        with open(target_path, "w") as f:
+            f.write(sample_config_content)
 
-    if os.path.exists(sample_config_path):
-        shutil.copy(sample_config_path, target_path)
         print(f"Generated sample config file at: {target_path}")
         print(
             "\nEdit this file with your Matrix and Meshtastic settings before running mmrelay."
         )
         return True
-    else:
+    except (FileNotFoundError, ImportError, OSError) as e:
+        print(f"Error accessing sample_config.yaml: {e}")
+
+        # Fallback to traditional file paths if importlib.resources fails
+        # First, check in the package directory
+        package_dir = os.path.dirname(__file__)
+        sample_config_paths = [
+            # Check in the tools subdirectory of the package
+            os.path.join(package_dir, "tools", "sample_config.yaml"),
+            # Check in the package directory
+            os.path.join(package_dir, "sample_config.yaml"),
+            # Check in the repository root
+            os.path.join(
+                os.path.dirname(os.path.dirname(package_dir)), "sample_config.yaml"
+            ),
+            # Check in the current directory
+            os.path.join(os.getcwd(), "sample_config.yaml"),
+        ]
+
+        for path in sample_config_paths:
+            if os.path.exists(path):
+                shutil.copy(path, target_path)
+                print(f"Generated sample config file at: {target_path}")
+                print(
+                    "\nEdit this file with your Matrix and Meshtastic settings before running mmrelay."
+                )
+                return True
+
         print("Error: Could not find sample_config.yaml")
         return False

mmrelay/main.py

@@ -9,6 +9,7 @@ import signal
 import sys
 
 from nio import ReactionEvent, RoomMessageEmote, RoomMessageNotice, RoomMessageText
+from nio.events.room_events import RoomMemberEvent
 
 # Import version from package
 # Import meshtastic_utils as a module to set event_loop
@@ -22,7 +23,7 @@ from mmrelay.db_utils import (
 from mmrelay.log_utils import get_logger
 from mmrelay.matrix_utils import connect_matrix, join_matrix_room
 from mmrelay.matrix_utils import logger as matrix_logger
-from mmrelay.matrix_utils import on_room_message
+from mmrelay.matrix_utils import on_room_message, on_room_member
 from mmrelay.meshtastic_utils import connect_meshtastic
 from mmrelay.meshtastic_utils import logger as meshtastic_logger
 from mmrelay.plugin_loader import load_plugins
@@ -109,6 +110,8 @@ async def main(config):
     )
     # Add ReactionEvent callback so we can handle matrix reactions
     matrix_client.add_event_callback(on_room_message, ReactionEvent)
+    # Add RoomMemberEvent callback to track room-specific display name changes
+    matrix_client.add_event_callback(on_room_member, RoomMemberEvent)
 
     # Set up shutdown event
     shutdown_event = asyncio.Event()

mmrelay/matrix_utils.py

@@ -18,6 +18,7 @@ from nio import (
     UploadResponse,
     WhoamiError,
 )
+from nio.events.room_events import RoomMemberEvent
 from PIL import Image
 
 from mmrelay.db_utils import (
@@ -517,8 +518,14 @@ async def on_room_message(
             meshtastic_id, matrix_room_id, meshtastic_text_db, meshtastic_meshnet_db = (
                 orig
             )
-            display_name_response = await matrix_client.get_displayname(event.sender)
-            full_display_name = display_name_response.displayname or event.sender
+            # Get room-specific display name if available, fallback to global display name
+            room_display_name = room.user_name(event.sender)
+            if room_display_name:
+                full_display_name = room_display_name
+            else:
+                # Fallback to global display name if room-specific name is not available
+                display_name_response = await matrix_client.get_displayname(event.sender)
+                full_display_name = display_name_response.displayname or event.sender
 
             # If not from a remote meshnet, proceed as normal to relay back to the originating meshnet
             short_display_name = full_display_name[:5]
@@ -578,8 +585,14 @@ async def on_room_message(
             return
     else:
         # Normal Matrix message from a Matrix user
-        display_name_response = await matrix_client.get_displayname(event.sender)
-        full_display_name = display_name_response.displayname or event.sender
+        # Get room-specific display name if available, fallback to global display name
+        room_display_name = room.user_name(event.sender)
+        if room_display_name:
+            full_display_name = room_display_name
+        else:
+            # Fallback to global display name if room-specific name is not available
+            display_name_response = await matrix_client.get_displayname(event.sender)
+            full_display_name = display_name_response.displayname or event.sender
         short_display_name = full_display_name[:5]
         prefix = f"{short_display_name}[M]: "
         logger.debug(f"Processing matrix message from [{full_display_name}]: {text}")
@@ -752,3 +765,38 @@ async def send_room_image(
         message_type="m.room.message",
         content={"msgtype": "m.image", "url": upload_response.content_uri, "body": ""},
     )
+
+
+async def on_room_member(room: MatrixRoom, event: RoomMemberEvent) -> None:
+    """
+    Callback to handle room member events, specifically tracking room-specific display name changes.
+    This ensures we detect when users update their display names in specific rooms.
+    """
+    # Only track updates from active members
+    if event.membership != "join":
+        return
+
+    new_displayname = event.content.get("displayname")
+    old_displayname = event.prev_content.get("displayname") if event.prev_content else None
+    user_id = event.state_key
+    room_id = room.room_id
+
+    # Log display name changes for debugging
+    if new_displayname != old_displayname:
+        if new_displayname and old_displayname:
+            logger.info(
+                f"[Matrix] {user_id} updated room display name in {room_id}: "
+                f"'{old_displayname}' → '{new_displayname}'"
+            )
+        elif new_displayname and not old_displayname:
+            logger.info(
+                f"[Matrix] {user_id} set room display name in {room_id}: '{new_displayname}'"
+            )
+        elif not new_displayname and old_displayname:
+            logger.info(
+                f"[Matrix] {user_id} removed room display name in {room_id}: '{old_displayname}' → (global name)"
+            )
+
+    # Note: We don't need to maintain a separate cache here since matrix-nio
+    # automatically updates the room state and room.user_name() will return
+    # the updated room-specific display name immediately after this event.

mmrelay/plugins/base_plugin.py

@@ -29,25 +29,28 @@ class BasePlugin(ABC):
     def description(self):
         return ""
 
-    def __init__(self) -> None:
-        # IMPORTANT NOTE FOR PLUGIN DEVELOPERS:
-        # When creating a plugin that inherits from BasePlugin, you MUST set
-        # self.plugin_name in your __init__ method BEFORE calling super().__init__()
-        # Example:
-        #   def __init__(self):
-        #       self.plugin_name = "your_plugin_name"  # Set this FIRST
-        #       super().__init__()                     # Then call parent
-        #
-        # Failure to do this will cause command recognition issues and other problems.
-
+    def __init__(self, plugin_name=None) -> None:
+        # Allow plugin_name to be passed as a parameter for simpler initialization
+        # This maintains backward compatibility while providing a cleaner API
         super().__init__()
 
-        # Verify plugin_name is properly defined
+        # If plugin_name is provided as a parameter, use it
+        if plugin_name is not None:
+            self.plugin_name = plugin_name
+
+        # For backward compatibility: if plugin_name is not provided as a parameter,
+        # check if it's set as an instance attribute (old way) or use the class attribute
         if not hasattr(self, "plugin_name") or self.plugin_name is None:
-            raise ValueError(
-                f"{self.__class__.__name__} is missing plugin_name definition. "
-                f"Make sure to set self.plugin_name BEFORE calling super().__init__()"
-            )
+            # Try to get the class-level plugin_name
+            class_plugin_name = getattr(self.__class__, "plugin_name", None)
+            if class_plugin_name is not None:
+                self.plugin_name = class_plugin_name
+            else:
+                raise ValueError(
+                    f"{self.__class__.__name__} is missing plugin_name definition. "
+                    f"Either set class.plugin_name, pass plugin_name to __init__, "
+                    f"or set self.plugin_name before calling super().__init__()"
+                )
 
         self.logger = get_logger(f"Plugin:{self.plugin_name}")
         self.config = {"active": False}
@@ -66,6 +69,8 @@ class BasePlugin(ABC):
                 room.get("meshtastic_channel")
                 for room in config.get("matrix_rooms", [])
             ]
+        else:
+            self.mapped_channels = []
 
         # Get the channels specified for this plugin, or default to all mapped channels
         self.channels = self.config.get("channels", self.mapped_channels)

mmrelay/plugins/drop_plugin.py

@@ -10,9 +10,8 @@ class Plugin(BasePlugin):
     plugin_name = "drop"
     special_node = "!NODE_MSGS!"
 
-    def __init__(self):
-        self.plugin_name = "drop"
-        super().__init__()
+    # No __init__ method needed with the simplified plugin system
+    # The BasePlugin will automatically use the class-level plugin_name
 
     def get_position(self, meshtastic_client, node_id):
         for _node, info in meshtastic_client.nodes.items():

mmrelay/plugins/help_plugin.py

@@ -7,9 +7,8 @@ from mmrelay.plugins.base_plugin import BasePlugin
 class Plugin(BasePlugin):
     plugin_name = "help"
 
-    def __init__(self):
-        self.plugin_name = "help"
-        super().__init__()
+    # No __init__ method needed with the simplified plugin system
+    # The BasePlugin will automatically use the class-level plugin_name
 
     @property
     def description(self):

mmrelay/plugins/map_plugin.py

@@ -235,9 +235,8 @@ async def send_image(client: AsyncClient, room_id: str, image: Image.Image):
 class Plugin(BasePlugin):
     plugin_name = "map"
 
-    def __init__(self):
-        self.plugin_name = "map"
-        super().__init__()
+    # No __init__ method needed with the simplified plugin system
+    # The BasePlugin will automatically use the class-level plugin_name
 
     @property
     def description(self):

mmrelay/plugins/ping_plugin.py

@@ -17,9 +17,8 @@ class Plugin(BasePlugin):
     plugin_name = "ping"
     punctuation = string.punctuation
 
-    def __init__(self):
-        self.plugin_name = "ping"
-        super().__init__()
+    # No __init__ method needed with the simplified plugin system
+    # The BasePlugin will automatically use the class-level plugin_name
 
     @property
     def description(self):

mmrelay/plugins/weather_plugin.py

@@ -9,9 +9,8 @@ from mmrelay.plugins.base_plugin import BasePlugin
 class Plugin(BasePlugin):
     plugin_name = "weather"
 
-    def __init__(self):
-        self.plugin_name = "weather"
-        super().__init__()
+    # No __init__ method needed with the simplified plugin system
+    # The BasePlugin will automatically use the class-level plugin_name
 
     @property
     def description(self):

mmrelay/setup_utils.py

@@ -5,6 +5,8 @@ This module provides simple functions for managing the systemd user service
 and generating configuration files.
 """
 
+import importlib.resources
+
 # Import version from package
 import os
 import shutil
@@ -12,6 +14,8 @@ import subprocess
 import sys
 from pathlib import Path
 
+from mmrelay.tools import get_service_template_path
+
 
 def get_executable_path():
     """Get the full path to the mmrelay executable.
@@ -103,16 +107,31 @@ def get_template_service_path():
         os.path.join(sys.prefix, "share", "mmrelay", "mmrelay.service"),
         os.path.join(sys.prefix, "share", "mmrelay", "tools", "mmrelay.service"),
         # Check in the user site-packages location
-        os.path.join(os.path.expanduser("~"), ".local", "share", "mmrelay", "mmrelay.service"),
-        os.path.join(os.path.expanduser("~"), ".local", "share", "mmrelay", "tools", "mmrelay.service"),
+        os.path.join(
+            os.path.expanduser("~"), ".local", "share", "mmrelay", "mmrelay.service"
+        ),
+        os.path.join(
+            os.path.expanduser("~"),
+            ".local",
+            "share",
+            "mmrelay",
+            "tools",
+            "mmrelay.service",
+        ),
         # Check one level up from the package directory
         os.path.join(os.path.dirname(package_dir), "tools", "mmrelay.service"),
         # Check two levels up from the package directory (for development)
-        os.path.join(os.path.dirname(os.path.dirname(package_dir)), "tools", "mmrelay.service"),
+        os.path.join(
+            os.path.dirname(os.path.dirname(package_dir)), "tools", "mmrelay.service"
+        ),
         # Check in the repository root (for development)
-        os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(__file__))), "tools", "mmrelay.service"),
+        os.path.join(
+            os.path.dirname(os.path.dirname(os.path.dirname(__file__))),
+            "tools",
+            "mmrelay.service",
+        ),
         # Check in the current directory (fallback)
-        os.path.join(os.getcwd(), "tools", "mmrelay.service")
+        os.path.join(os.getcwd(), "tools", "mmrelay.service"),
     ]
 
     # Try each path until we find one that exists
@@ -136,8 +155,10 @@ def get_template_service_content():
     Returns:
         str: The content of the template service file, or a default template if not found.
     """
-    template_path = get_template_service_path()
-    if template_path:
+    # Use the helper function to get the service template path
+    template_path = get_service_template_path()
+
+    if template_path and os.path.exists(template_path):
         # Read the template from file
         try:
             with open(template_path, "r") as f:
@@ -146,6 +167,28 @@ def get_template_service_content():
         except Exception as e:
             print(f"Error reading service template file: {e}")
 
+    # If the helper function failed, try using importlib.resources directly
+    try:
+        service_template = (
+            importlib.resources.files("mmrelay.tools")
+            .joinpath("mmrelay.service")
+            .read_text()
+        )
+        return service_template
+    except (FileNotFoundError, ImportError, OSError) as e:
+        print(f"Error accessing mmrelay.service via importlib.resources: {e}")
+
+        # Fall back to the file path method
+        template_path = get_template_service_path()
+        if template_path:
+            # Read the template from file
+            try:
+                with open(template_path, "r") as f:
+                    service_template = f.read()
+                return service_template
+            except Exception as e:
+                print(f"Error reading service template file: {e}")
+
     # If we couldn't find or read the template file, use a default template
     print("Using default service template")
     return """[Unit]
@@ -154,7 +197,7 @@ After=network-online.target
 Wants=network-online.target
 
 [Service]
-Type=idle
+Type=simple
 # The mmrelay binary can be installed via pipx or pip
 ExecStart=%h/.local/bin/mmrelay --config %h/.mmrelay/config.yaml --logfile %h/.mmrelay/logs/mmrelay.log
 WorkingDirectory=%h/.mmrelay
@@ -310,6 +353,69 @@ def service_needs_update():
     return False, "Service file is up to date"
 
 
+def check_loginctl_available():
+    """Check if loginctl is available on the system.
+
+    Returns:
+        bool: True if loginctl is available, False otherwise.
+    """
+    try:
+        result = subprocess.run(
+            ["which", "loginctl"],
+            check=False,
+            capture_output=True,
+            text=True,
+        )
+        return result.returncode == 0
+    except Exception:
+        return False
+
+
+def check_lingering_enabled():
+    """Check if user lingering is enabled.
+
+    Returns:
+        bool: True if lingering is enabled, False otherwise.
+    """
+    try:
+        username = os.environ.get("USER", os.environ.get("USERNAME"))
+        result = subprocess.run(
+            ["loginctl", "show-user", username, "--property=Linger"],
+            check=False,
+            capture_output=True,
+            text=True,
+        )
+        return result.returncode == 0 and "Linger=yes" in result.stdout
+    except Exception:
+        return False
+
+
+def enable_lingering():
+    """Enable user lingering using sudo.
+
+    Returns:
+        bool: True if lingering was enabled successfully, False otherwise.
+    """
+    try:
+        username = os.environ.get("USER", os.environ.get("USERNAME"))
+        print(f"Enabling lingering for user {username}...")
+        result = subprocess.run(
+            ["sudo", "loginctl", "enable-linger", username],
+            check=False,
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode == 0:
+            print("Lingering enabled successfully")
+            return True
+        else:
+            print(f"Error enabling lingering: {result.stderr}")
+            return False
+    except Exception as e:
+        print(f"Error enabling lingering: {e}")
+        return False
+
+
 def install_service():
     """Install or update the MMRelay user service."""
     # Check if service already exists
@@ -355,6 +461,27 @@ def install_service():
 
     # We don't need to validate the config here as it will be validated when the service starts
 
+    # Check if loginctl is available
+    loginctl_available = check_loginctl_available()
+    if loginctl_available:
+        # Check if user lingering is enabled
+        lingering_enabled = check_lingering_enabled()
+        if not lingering_enabled:
+            print(
+                "\nUser lingering is not enabled. This is required for the service to start automatically at boot."
+            )
+            print(
+                "Lingering allows user services to run even when you're not logged in."
+            )
+            if (
+                input(
+                    "Do you want to enable lingering for your user? (requires sudo) (y/n): "
+                )
+                .lower()
+                .startswith("y")
+            ):
+                enable_lingering()
+
     # Check if the service is already enabled
     service_enabled = is_service_enabled()
     if service_enabled:
@@ -417,6 +544,8 @@ def install_service():
     print("\nService Status Summary:")
     print(f"  Service File: {service_path}")
     print(f"  Enabled at Boot: {'Yes' if service_enabled else 'No'}")
+    if loginctl_available:
+        print(f"  User Lingering: {'Yes' if check_lingering_enabled() else 'No'}")
     print(f"  Currently Running: {'Yes' if is_service_active() else 'No'}")
     print("\nService Management Commands:")
     print_service_commands()

mmrelay/tools/__init__.py

@@ -0,0 +1,28 @@
+"""Tools and resources for MMRelay."""
+
+import importlib.resources
+import pathlib
+
+
+def get_sample_config_path():
+    """Get the path to the sample config file."""
+    try:
+        # For Python 3.9+
+        return str(
+            importlib.resources.files("mmrelay.tools").joinpath("sample_config.yaml")
+        )
+    except AttributeError:
+        # Fallback for older Python versions
+        return str(pathlib.Path(__file__).parent / "sample_config.yaml")
+
+
+def get_service_template_path():
+    """Get the path to the service template file."""
+    try:
+        # For Python 3.9+
+        return str(
+            importlib.resources.files("mmrelay.tools").joinpath("mmrelay.service")
+        )
+    except AttributeError:
+        # Fallback for older Python versions
+        return str(pathlib.Path(__file__).parent / "mmrelay.service")

mmrelay/tools/mmrelay.service

@@ -0,0 +1,18 @@
+[Unit]
+Description=A Meshtastic <=> Matrix Relay
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+# The mmrelay binary can be installed via pipx or pip
+ExecStart=%h/.local/bin/mmrelay --config %h/.mmrelay/config.yaml --logfile %h/.mmrelay/logs/mmrelay.log
+WorkingDirectory=%h/.mmrelay
+Restart=on-failure
+RestartSec=10
+Environment=PYTHONUNBUFFERED=1
+# 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
+
+[Install]
+WantedBy=default.target

mmrelay/tools/sample_config.yaml

@@ -0,0 +1,64 @@
+matrix:
+  homeserver: https://example.matrix.org
+  access_token: reaalllllyloooooongsecretttttcodeeeeeeforrrrbot # See: https://t2bot.io/docs/access_tokens/
+  bot_user_id: "@botuser:example.matrix.org"
+
+matrix_rooms: # Needs at least 1 room & channel, but supports all Meshtastic channels
+  - id: "#someroomalias:example.matrix.org" # Matrix room aliases & IDs supported
+    meshtastic_channel: 0
+  - id: "!someroomid:example.matrix.org"
+    meshtastic_channel: 2
+
+meshtastic:
+  connection_type: serial # Choose either "tcp", "serial", or "ble"
+  serial_port: /dev/ttyUSB0 # Only used when connection is "serial"
+  host: meshtastic.local # Only used when connection is "tcp"
+  ble_address: AA:BB:CC:DD:EE:FF # Only used when connection is "ble" - Uses either an address or name from a `meshtastic --ble-scan`
+  meshnet_name: Your Meshnet Name # This is displayed in full on Matrix, but is truncated when sent to a Meshnet
+  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
+  plugin_response_delay: 3 # Default response delay in seconds for plugins that respond on the mesh;
+  relay_reactions: true # Defaults to false, set to true to enable relay reactions between platforms
+
+logging:
+  level: info
+  #log_to_file: true                          # Set to true to enable file logging
+  #filename: ~/.mmrelay/logs/mmrelay.log      # Default location if log_to_file is true
+  #max_log_size: 10485760                     # 10 MB default if omitted
+  #backup_count: 1                            # Keeps 1 backup as the default if omitted
+  #color_enabled: true                        # Set to false to disable colored console output
+
+#database:
+#  path: ~/.mmrelay/data/meshtastic.sqlite   # Default location
+#  msg_map: # The message map is necessary for the relay_reactions functionality. If `relay_reactions` is set to false, nothing will be saved to the message map.
+#    msgs_to_keep: 500 # If set to 0, it will not delete any messages; Defaults to 500
+#    wipe_on_restart: true # Clears out the message map when the relay is restarted; Defaults to False
+
+# These are core Plugins - Note: Some plugins are experimental and some need maintenance.
+plugins:
+  ping:
+    active: true
+    #channels: [2,3,5] # List of channels the plugin will respond to; DMs are always processed if the plugin is active
+  weather:
+    active: true
+    units: imperial # Options: metric, imperial - Default is metric
+    #channels: [] # Empty list, will only respond to DMs
+  nodes:
+    active: true
+    # Does not need to specify channels, as it's a Matrix-only plugin
+
+#community-plugins:
+#  sample_plugin:
+#    active: true
+#    repository: https://github.com/username/sample_plugin.git
+#    tag: master
+#  advanced_plugin:
+#    active: false
+#    repository: https://github.com/username/advanced_plugin.git
+#    tag: v1.2.0
+
+#custom-plugins:
+#  my_custom_plugin:
+#    active: true
+#  another_custom_plugin:
+#    active: false

{mmrelay-1.0.6.dist-info → mmrelay-1.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mmrelay
-Version: 1.0.6
+Version: 1.0.8
 Summary: Bridge between Meshtastic mesh networks and Matrix chat rooms
 Home-page: https://github.com/geoffwhittington/meshtastic-matrix-relay
 Author: Geoff Whittington, Jeremiah K., and contributors
@@ -22,72 +22,45 @@ Requires-Dist: requests==2.32.3
 Requires-Dist: markdown==3.8
 Requires-Dist: haversine==2.9.0
 Requires-Dist: schedule==1.2.2
-Requires-Dist: platformdirs==4.3.7
+Requires-Dist: platformdirs==4.3.8
 Requires-Dist: py-staticmaps>=0.4.0
 Requires-Dist: rich==14.0.0
-Requires-Dist: setuptools==80.3.1
+Requires-Dist: setuptools==80.8.0
 Dynamic: license-file
 
 # M<>M Relay
 
-## ✨ Version 1.0 Released! ✨
+## (Meshtastic <=> Matrix Relay)
 
-**We're excited to announce MMRelay v1.0 with improved packaging, standardized directories, and enhanced CLI!**
+A powerful and easy-to-use relay between Meshtastic devices and Matrix chat rooms, allowing seamless communication across platforms. This opens the door for bridging Meshtastic devices to [many other platforms](https://matrix.org/bridges/).
 
-**Existing users:** Version 1.0 requires a few quick migration steps:
+## Documentation
 
-1. Follow the [UPGRADE_TO_V1.md](UPGRADE_TO_V1.md) guide for a smooth transition
-2. Move your configuration to the new standard location (`~/.mmrelay/config.yaml`)
-3. See [ANNOUNCEMENT.md](ANNOUNCEMENT.md) for all the exciting new features
+Visit our [Wiki](https://github.com/geoffwhittington/meshtastic-matrix-relay/wiki) for comprehensive guides and information.
 
-Not ready to upgrade yet? No problem! Run `git checkout 0.10.1` to continue using the previous version.
-
-## (Meshtastic <=> Matrix Relay)
-
-A powerful and easy-to-use relay between Meshtastic devices and Matrix chat rooms, allowing seamless communication across platforms. This opens the door for bridging Meshtastic devices to [many other platforms](https://matrix.org/bridges/).
+- [Installation Instructions](docs/INSTRUCTIONS.md) - Setup and configuration guide
+- [v1.0 Release Announcement](docs/ANNOUNCEMENT.md) - New changes in v1.0
+- [Upgrade Guide](docs/UPGRADE_TO_V1.md) - Migration guidance for existing users
 
 ---
 
-## Getting Started
+## Quick Start
 
 MMRelay runs on Linux, macOS, and Windows.
 
-### Quick Installation
-
 ```bash
 # Install using pipx for isolated installation (recommended)
 pipx install mmrelay
 
-# Pip will also work if you prefer
-pip install mmrelay
-```
-
-For pipx installation instructions, see: [pipx installation guide](https://pipx.pypa.io/stable/installation/#on-linux)
+# Generate a sample configuration file & then edit it
+mmrelay --generate-config
 
-### Resources
-
-- **New Users**: See [INSTRUCTIONS.md](INSTRUCTIONS.md) for setup and configuration
-- **Existing Users**: See [UPGRADE_TO_V1.md](UPGRADE_TO_V1.md) for migration guidance
-- **Configuration**: Review [sample_config.yaml](sample_config.yaml) for examples
-
-### Command-Line Options
-
-```bash
-usage: mmrelay [-h] [--config CONFIG] [--data-dir DATA_DIR] [--log-level {error,warning,info,debug}] [--logfile LOGFILE] [--version] [--generate-config] [--install-service] [--check-config]
-
-Options:
-  -h, --help            Show this help message and exit
-  --config CONFIG       Path to config file
-  --data-dir DATA_DIR   Base directory for all data (logs, database, plugins)
-  --log-level {error,warning,info,debug}
-                        Set logging level
-  --logfile LOGFILE     Path to log file (can be overridden by --data-dir)
-  --version             Show version and exit
-  --generate-config     Generate a sample config.yaml file
-  --install-service     Install or update the systemd user service
-  --check-config        Check if the configuration file is valid
+# Start the relay (without --install-service to run manually)
+mmrelay --install-service
 ```
 
+For detailed installation and configuration instructions, see the [Installation Guide](docs/INSTRUCTIONS.md).
+
 ---
 
 ## Features
@@ -133,7 +106,12 @@ See the full list of core plugins [here](https://github.com/geoffwhittington/mes
 
 ### Community & Custom Plugins
 
-It is possible to create custom plugins and share them with the community. Check [example_plugins/README.md](https://github.com/geoffwhittington/meshtastic-matrix-relay/tree/main/example_plugins) and the [Community Plugins Development Guide](https://github.com/geoffwhittington/meshtastic-matrix-relay/wiki/Community-Plugin-Development-Guide).
+MMRelay's plugin system allows you to extend functionality in two ways:
+
+- **Custom Plugins**: Create personal plugins for your own use, stored in `~/.mmrelay/plugins/custom/`
+- **Community Plugins**: Share your creations with others or use plugins developed by the community
+
+Check the [Community Plugins Development Guide](https://github.com/geoffwhittington/meshtastic-matrix-relay/wiki/Community-Plugin-Development-Guide) in our wiki to get started.
 
 ✨️ Visit the [Community Plugins List](https://github.com/geoffwhittington/meshtastic-matrix-relay/wiki/Community-Plugin-List)!
 
@@ -151,14 +129,12 @@ community-plugins:
 
 ### Plugin System
 
-MMRelay features a powerful plugin system with standardized locations:
+Plugins make it easy to extend functionality without modifying the core program. MMRelay features a powerful plugin system with standardized locations:
 
 - **Core Plugins**: Pre-installed with the package
 - **Custom Plugins**: Your own plugins in `~/.mmrelay/plugins/custom/`
 - **Community Plugins**: Third-party plugins in `~/.mmrelay/plugins/community/`
 
-Plugins make it easy to extend functionality without modifying the core code.
-
 ---
 
 ## Getting Started with Matrix

mmrelay-1.0.8.dist-info/RECORD

@@ -0,0 +1,32 @@
+mmrelay/__init__.py,sha256=m8l2zIk6h1Ba54Ru2fsB0Ujsi_4btG1sZ40XjtYK0Mg,588
+mmrelay/cli.py,sha256=hdPTlcGsXTJC9GEUiScG7b3IFp02B3lwhqgwFpU3NsM,13835
+mmrelay/config.py,sha256=5VZag8iSc5yLQgvwI76bbpizbtqag74cHnfXCrWHNyA,7910
+mmrelay/config_checker.py,sha256=UnoHVTXzfdTfFkbmXv9r_Si76v-sxXLb5FOaQSOM45E,4909
+mmrelay/db_utils.py,sha256=DP2YuKBZtV771wo9X-Z7Ww5txfaIR0inWh1K_oVZ7cA,11430
+mmrelay/log_utils.py,sha256=FXhaq4WSDHwlqiG3k1BbSxiOl5be4P4Kyr1gsIThOBw,4572
+mmrelay/main.py,sha256=4Cgv5bLwX9JLMAYmY4TePRY8XDMEKcj3ghYicBwednA,11301
+mmrelay/matrix_utils.py,sha256=7rjjHtm8JNXi2fgZ33L3VRvxomA9gQw3dJD6mqZi_lY,32770
+mmrelay/meshtastic_utils.py,sha256=Pd0j7mz008ncBDIjRGyHOIb0U3vKq06uXWoJP-csHcQ,23381
+mmrelay/plugin_loader.py,sha256=Gg8E_TKqndMQHiVJwtmlIC-jCgcty-5EsX_5JJ6Onvo,36590
+mmrelay/setup_utils.py,sha256=N6qdScHKHEMFKDmT1l7dcLDPNTusZXPkyxrLXjFLhRI,19910
+mmrelay/plugins/__init__.py,sha256=KVMQIXRhe0wlGj4O3IZ0vOIQRKFkfPYejHXhJL17qrc,51
+mmrelay/plugins/base_plugin.py,sha256=AlC7Y0jMh42jouXpJNtpvo4vMbS0KedOUFuJvWmZggY,8962
+mmrelay/plugins/debug_plugin.py,sha256=Jziht9Nj_bRO6Rmy7TjfBXaYo5eM3XsenbWFxPpyUs4,443
+mmrelay/plugins/drop_plugin.py,sha256=0GOz0dgLnFST1HTgqrMayrjwmYlnu02QxfnTZtdPZ3U,4671
+mmrelay/plugins/health_plugin.py,sha256=svV_GfpAVL0QhiVzi3PVZ1mNpsOL1NHSmkRF-Mn_ExE,2250
+mmrelay/plugins/help_plugin.py,sha256=GP7i1iWNiJxb_Pbuod0ctveIQYL1FNN8ctUvy24yRNM,1506
+mmrelay/plugins/map_plugin.py,sha256=xqQvjuY-VVuuhVQyDJHnj9uZKYaXV0qSaBTbVwfVOfo,10078
+mmrelay/plugins/mesh_relay_plugin.py,sha256=E04JU4uKr7KTScahS0VKBJ1xwvq1ULJaeFVYEtceMvA,4273
+mmrelay/plugins/nodes_plugin.py,sha256=RDabzyG5hKG5aYWecsRUcLSjMCCv6Pngmq2Qpld1A1U,2903
+mmrelay/plugins/ping_plugin.py,sha256=8uFnT3qfO3RBaTUOx348voIfKpzXB3zTfcT6Gtfc8kM,4070
+mmrelay/plugins/telemetry_plugin.py,sha256=8SxWv4BLXMUTbiVaD3MjlMMdQyS7S_1OfLlVNAUMSO0,6306
+mmrelay/plugins/weather_plugin.py,sha256=1bQhmiX-enNphzGoFVprU0LcZQX9BvGxWAJAG8Wekg0,8596
+mmrelay/tools/__init__.py,sha256=WFjDQjdevgg19_zT6iEoL29rvb1JPqYSd8708Jn5D7A,838
+mmrelay/tools/mmrelay.service,sha256=3vqK1VbfXvVftkTrTEOan77aTHeOT36hIAL7HqJsmTg,567
+mmrelay/tools/sample_config.yaml,sha256=iGOoVxELUEJwfmpFxyeWXXS0RWNsErnf8-6LXyIwH2k,3052
+mmrelay-1.0.8.dist-info/licenses/LICENSE,sha256=yceWauM1c0-FHxVplsD7W1-AbSeRaUNlmqT4UO1msBU,1073
+mmrelay-1.0.8.dist-info/METADATA,sha256=orw_9ScvoB4pOpJMkQ5WJvfLEZphl7N5OD0oRHpyIC8,5916
+mmrelay-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mmrelay-1.0.8.dist-info/entry_points.txt,sha256=SJZwGUOEpQ-qx4H8UL4xKFnKeInGUaZNW1I0ddjK7Ws,45
+mmrelay-1.0.8.dist-info/top_level.txt,sha256=B_ZLCRm7NYAmI3PipRUyHGymP-C-q16LSeMGzmqJfo4,8
+mmrelay-1.0.8.dist-info/RECORD,,

{mmrelay-1.0.6.dist-info → mmrelay-1.0.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

mmrelay-1.0.6.dist-info/RECORD

@@ -1,29 +0,0 @@
-mmrelay/__init__.py,sha256=8fghAZAeSUb8uIaiit0FGNUWI0ZsBR__QbXNwqNbGtw,588
-mmrelay/cli.py,sha256=yBYOkCwGYDJ2gRKPoPltxB_PydX1CPNUerVJHcNuHTo,12355
-mmrelay/config.py,sha256=5VZag8iSc5yLQgvwI76bbpizbtqag74cHnfXCrWHNyA,7910
-mmrelay/config_checker.py,sha256=UnoHVTXzfdTfFkbmXv9r_Si76v-sxXLb5FOaQSOM45E,4909
-mmrelay/db_utils.py,sha256=DP2YuKBZtV771wo9X-Z7Ww5txfaIR0inWh1K_oVZ7cA,11430
-mmrelay/log_utils.py,sha256=FXhaq4WSDHwlqiG3k1BbSxiOl5be4P4Kyr1gsIThOBw,4572
-mmrelay/main.py,sha256=acgBF-DnL0Rs8MmYAfbNHZ9xjqM3Qc0_oKtATN4iOEE,11085
-mmrelay/matrix_utils.py,sha256=GkIVj2bbPHtx1emFMwhEhc1SWHcv4UvkuyZYdb-Wnwo,30511
-mmrelay/meshtastic_utils.py,sha256=Pd0j7mz008ncBDIjRGyHOIb0U3vKq06uXWoJP-csHcQ,23381
-mmrelay/plugin_loader.py,sha256=Gg8E_TKqndMQHiVJwtmlIC-jCgcty-5EsX_5JJ6Onvo,36590
-mmrelay/setup_utils.py,sha256=UZLX944GyiUQPUGNGNDwLocgShA8SzOJtvfntEu821A,16060
-mmrelay/plugins/__init__.py,sha256=KVMQIXRhe0wlGj4O3IZ0vOIQRKFkfPYejHXhJL17qrc,51
-mmrelay/plugins/base_plugin.py,sha256=hv21tSEYG-AB36aLAFdW9DDKm0NOTRNPpGIO5F3i1ts,8633
-mmrelay/plugins/debug_plugin.py,sha256=Jziht9Nj_bRO6Rmy7TjfBXaYo5eM3XsenbWFxPpyUs4,443
-mmrelay/plugins/drop_plugin.py,sha256=ACchX6GfEldqTyvsZVg-5jwbe2-CjENQVVZFnw8SaEM,4618
-mmrelay/plugins/health_plugin.py,sha256=svV_GfpAVL0QhiVzi3PVZ1mNpsOL1NHSmkRF-Mn_ExE,2250
-mmrelay/plugins/help_plugin.py,sha256=-C4M1PPi1m-fPRvNAlcMyHDNiEEIF6013z2vzrepa1Q,1453
-mmrelay/plugins/map_plugin.py,sha256=tWzNvErSoIjqpWtdR-uhbnqdX1SQZl1XQn3Qrp195Kk,10024
-mmrelay/plugins/mesh_relay_plugin.py,sha256=E04JU4uKr7KTScahS0VKBJ1xwvq1ULJaeFVYEtceMvA,4273
-mmrelay/plugins/nodes_plugin.py,sha256=RDabzyG5hKG5aYWecsRUcLSjMCCv6Pngmq2Qpld1A1U,2903
-mmrelay/plugins/ping_plugin.py,sha256=RTRdgDQUSO33lreDTmWsTlI0L1C3FJrXE0KYqfEWYO0,4017
-mmrelay/plugins/telemetry_plugin.py,sha256=8SxWv4BLXMUTbiVaD3MjlMMdQyS7S_1OfLlVNAUMSO0,6306
-mmrelay/plugins/weather_plugin.py,sha256=yoKA_HdFqFEhgYdXqLhvXatLphCyLJFuGUKCR7fILv0,8546
-mmrelay-1.0.6.dist-info/licenses/LICENSE,sha256=yceWauM1c0-FHxVplsD7W1-AbSeRaUNlmqT4UO1msBU,1073
-mmrelay-1.0.6.dist-info/METADATA,sha256=V_JcF794O_pNB39Bm3K1TxVpB3C5f1lWYGQu4s3j3Dc,6987
-mmrelay-1.0.6.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-mmrelay-1.0.6.dist-info/entry_points.txt,sha256=SJZwGUOEpQ-qx4H8UL4xKFnKeInGUaZNW1I0ddjK7Ws,45
-mmrelay-1.0.6.dist-info/top_level.txt,sha256=B_ZLCRm7NYAmI3PipRUyHGymP-C-q16LSeMGzmqJfo4,8
-mmrelay-1.0.6.dist-info/RECORD,,