matter-web-controller 0.1.0__tar.gz

matter_web_controller-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nguyen Ha Dong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

matter_web_controller-0.1.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: matter-web-controller
+Version: 0.1.0
+Summary: Using websocket matter server to query/control matter-enabled lights/sensors via a HTTP GET interface.
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: home-assistant-chip-core
+Requires-Dist: home-assistant-chip-clusters
+Requires-Dist: cryptography
+Requires-Dist: python-matter-server
+Requires-Dist: zeroconf
+Dynamic: license-file
+
+# Matter Web Controller
+
+This document explains how the local Matter device management system works using a web interface.
+
+## System Architecture
+
+The system separates background tasks and simplifies network rules to make it easier to use:
+
+1. **Background Process:** The app runs the standard `python-matter-server` as a separate background task. This keeps the heavy work away from the web server.
+2. **WebSockets Connection:** The web server keeps a constant connection to the background task. This updates the network data in real time without slowing things down.
+3. **HTTP Setup:** The web server acts as a middleman. It changes complex WebSocket data into a simple HTTP GET link. Users only need to visit a simple web address to get JSON data.
+
+## Requirements
+
+You need Python 3.10 or newer.
+
+## Installation
+
+Create a virtual environment and install the package using your package manager. This will automatically install required tools like `aiohttp` and `home-assistant-chip-core`.
+
+## How to Run
+
+Start the system by typing the executable command `matter-server-start`. You can use the `--port` parameter to set the web server port. The default is 8080. The background Matter server will automatically use the next port number.
+
+## API Endpoints
+
+### Get lighting device status
+
+* **URL:** `/api/lights`
+* **Method:** `GET`
+* **Description:** Gets a list of all devices that have lighting features on the local Matter network. The data includes the Node ID, Endpoint ID, power state, and current brightness level.
+* **Example:** `http://localhost:8080/api/lights`

matter_web_controller-0.1.0/README.md

@@ -0,0 +1,32 @@
+# Matter Web Controller
+
+This document explains how the local Matter device management system works using a web interface.
+
+## System Architecture
+
+The system separates background tasks and simplifies network rules to make it easier to use:
+
+1. **Background Process:** The app runs the standard `python-matter-server` as a separate background task. This keeps the heavy work away from the web server.
+2. **WebSockets Connection:** The web server keeps a constant connection to the background task. This updates the network data in real time without slowing things down.
+3. **HTTP Setup:** The web server acts as a middleman. It changes complex WebSocket data into a simple HTTP GET link. Users only need to visit a simple web address to get JSON data.
+
+## Requirements
+
+You need Python 3.10 or newer.
+
+## Installation
+
+Create a virtual environment and install the package using your package manager. This will automatically install required tools like `aiohttp` and `home-assistant-chip-core`.
+
+## How to Run
+
+Start the system by typing the executable command `matter-server-start`. You can use the `--port` parameter to set the web server port. The default is 8080. The background Matter server will automatically use the next port number.
+
+## API Endpoints
+
+### Get lighting device status
+
+* **URL:** `/api/lights`
+* **Method:** `GET`
+* **Description:** Gets a list of all devices that have lighting features on the local Matter network. The data includes the Node ID, Endpoint ID, power state, and current brightness level.
+* **Example:** `http://localhost:8080/api/lights`

matter_web_controller-0.1.0/cli/server.py

@@ -0,0 +1,92 @@
+import argparse
+import asyncio
+import logging
+from aiohttp import web, ClientSession
+from matter_server.client.client import MatterClient
+
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+
+global_session = None
+global_client = None
+global_matter_process = None
+global_listen_task = None
+
+MATTER_PORT = 5580
+MATTER_SERVER_URL = ""
+
+async def init_servers(app):
+    global global_session, global_client, global_matter_process, global_listen_task
+    
+    logging.info(f"1. Launching internal Matter Server subprocess on port {MATTER_PORT}...")
+    global_matter_process = await asyncio.create_subprocess_exec(
+        "python3", "-m", "matter_server.server", "--storage-path", "./matter_storage", "--port", str(MATTER_PORT),
+        stdout=asyncio.subprocess.DEVNULL,
+        stderr=asyncio.subprocess.DEVNULL
+    )
+    
+    await asyncio.sleep(4.0)
+    
+    logging.info("2. Establishing client connection (ClientSession)...")
+    global_session = ClientSession()
+    global_client = MatterClient(MATTER_SERVER_URL, global_session)
+    
+    logging.info("3. Activating background listening task...")
+    global_listen_task = asyncio.create_task(global_client.start_listening())
+    
+    await asyncio.sleep(2.0)
+    logging.info("4. DONE: Web server is ready to accept HTTP requests!")
+
+async def close_servers(app):
+    logging.info("Executing resource cleanup procedures...")
+    if global_listen_task:
+        global_listen_task.cancel()
+    if global_session:
+        await global_session.close()
+    if global_matter_process:
+        logging.info("Terminating internal Matter Server subprocess...")
+        global_matter_process.terminate()
+        await global_matter_process.wait()
+
+async def serve_lighting_api(request):
+    logging.info("--- Received HTTP GET request at /api/lights ---")
+    if not global_client:
+         return web.json_response({"error": "Server not ready"}, status=503)
+
+    nodes = global_client.get_nodes()
+    logging.info(f"DONE: Retrieved data for {len(nodes)} network nodes.")
+
+    lighting_devices = []
+    for node in nodes:
+        for endpoint_id, endpoint in node.endpoints.items():
+            if 6 in endpoint.clusters:
+                power_state = node.get_attribute_value(endpoint_id, 6, 0)
+                brightness_level = node.get_attribute_value(endpoint_id, 8, 0) if 8 in endpoint.clusters else None
+                
+                lighting_devices.append({
+                    "id": f"Node {node.node_id} - EP {endpoint_id}",
+                    "state": power_state,
+                    "brightness": brightness_level
+                })
+    
+    return web.json_response(lighting_devices)
+
+def main():
+    parser = argparse.ArgumentParser(description="Matter API Web Server")
+    parser.add_argument("--port", type=int, default=8080, help="Web server port (Matter port will be port + 1)")
+    args = parser.parse_args()
+
+    web_port = args.port
+    global MATTER_PORT, MATTER_SERVER_URL
+    MATTER_PORT = web_port + 1
+    MATTER_SERVER_URL = f"ws://localhost:{MATTER_PORT}/ws"
+
+    app = web.Application()
+    app.on_startup.append(init_servers)
+    app.on_cleanup.append(close_servers)
+    app.router.add_get('/api/lights', serve_lighting_api)
+    
+    logging.info(f"Bootstrapping Web server on port {web_port}, Matter server on port {MATTER_PORT}...")
+    web.run_app(app, host='0.0.0.0', port=web_port)
+
+if __name__ == '__main__':
+    main()

matter_web_controller-0.1.0/matter_web_controller.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: matter-web-controller
+Version: 0.1.0
+Summary: Using websocket matter server to query/control matter-enabled lights/sensors via a HTTP GET interface.
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: home-assistant-chip-core
+Requires-Dist: home-assistant-chip-clusters
+Requires-Dist: cryptography
+Requires-Dist: python-matter-server
+Requires-Dist: zeroconf
+Dynamic: license-file
+
+# Matter Web Controller
+
+This document explains how the local Matter device management system works using a web interface.
+
+## System Architecture
+
+The system separates background tasks and simplifies network rules to make it easier to use:
+
+1. **Background Process:** The app runs the standard `python-matter-server` as a separate background task. This keeps the heavy work away from the web server.
+2. **WebSockets Connection:** The web server keeps a constant connection to the background task. This updates the network data in real time without slowing things down.
+3. **HTTP Setup:** The web server acts as a middleman. It changes complex WebSocket data into a simple HTTP GET link. Users only need to visit a simple web address to get JSON data.
+
+## Requirements
+
+You need Python 3.10 or newer.
+
+## Installation
+
+Create a virtual environment and install the package using your package manager. This will automatically install required tools like `aiohttp` and `home-assistant-chip-core`.
+
+## How to Run
+
+Start the system by typing the executable command `matter-server-start`. You can use the `--port` parameter to set the web server port. The default is 8080. The background Matter server will automatically use the next port number.
+
+## API Endpoints
+
+### Get lighting device status
+
+* **URL:** `/api/lights`
+* **Method:** `GET`
+* **Description:** Gets a list of all devices that have lighting features on the local Matter network. The data includes the Node ID, Endpoint ID, power state, and current brightness level.
+* **Example:** `http://localhost:8080/api/lights`

matter_web_controller-0.1.0/matter_web_controller.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+cli/__init__.py
+cli/server.py
+matter_web_controller.egg-info/PKG-INFO
+matter_web_controller.egg-info/SOURCES.txt
+matter_web_controller.egg-info/dependency_links.txt
+matter_web_controller.egg-info/entry_points.txt
+matter_web_controller.egg-info/requires.txt
+matter_web_controller.egg-info/top_level.txt

matter_web_controller-0.1.0/matter_web_controller.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

matter_web_controller-0.1.0/matter_web_controller.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+yeelight-srv = cli.server:main

matter_web_controller-0.1.0/matter_web_controller.egg-info/requires.txt

@@ -0,0 +1,6 @@
+aiohttp
+home-assistant-chip-core
+home-assistant-chip-clusters
+cryptography
+python-matter-server
+zeroconf

matter_web_controller-0.1.0/matter_web_controller.egg-info/top_level.txt

@@ -0,0 +1 @@
+cli

matter_web_controller-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "matter-web-controller"
+version = "0.1.0"
+description = "Using websocket matter server to query/control matter-enabled lights/sensors via a HTTP GET interface."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "aiohttp",
+    "home-assistant-chip-core",
+    "home-assistant-chip-clusters",
+    "cryptography",
+    "python-matter-server",
+    "zeroconf"
+]
+
+[project.scripts]
+yeelight-srv = "cli.server:main"
+
+[tool.isort]
+profile = "black"
+
+[tool.black]
+line-length = 88
+target-version = ["py312"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+
+[tool.mypy]
+python_version = "3.12"
+strict = true

matter_web_controller-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+