pycentauri 0.2.0__tar.gz → 0.3.1__tar.gz

{pycentauri-0.2.0 → pycentauri-0.3.1}/CHANGELOG.md

@@ -6,6 +6,39 @@ Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-04-22
+
+### Changed
+- **Web UI redesign.** Moved from the generic dark-dashboard look to an
+  industrial instrument-panel aesthetic — amber-on-near-black, viewfinder
+  corner brackets and a faint crosshair over the webcam, ruler-style
+  progress bar with diagonal-hatch fill, tabular-numeric temperature
+  gauges with per-channel setpoint bars, kinematics readout with X/Y/Z
+  cells and fan/Z-offset/mainboard telemetry, keyboard-key-style F1/F2/F3
+  control buttons (with real keyboard shortcuts). Typography: Space Mono
+  for display numerals, IBM Plex Mono for data, IBM Plex Sans Condensed
+  for SCADA-style labels.
+- Webcam MJPEG element now auto-recovers if the stream stalls for 15s.
+- Added a favicon so browsers stop 404-ing `/favicon.ico`.
+
+## [0.3.0] - 2026-04-22
+
+### Added
+- **Web UI** at `GET /ui/` (and `GET /` redirects there). Single static
+  dashboard bundled in the wheel — no build step, no framework. Shows
+  live webcam (MJPEG), progress bar, layer counter, temperature cards,
+  position, fans, and Z-offset. Pause / Resume / Stop buttons auto-appear
+  when the server is launched with `--enable-control`.
+- `GET /stream` — MJPEG proxy through the API server to the printer's
+  `:3031/video`. Browsers render it directly in an `<img>` tag.
+- `GET /api/info` — JSON health endpoint, matching what `GET /` used to
+  return before it was repurposed to redirect to `/ui/`.
+
+### Changed
+- `GET /` now redirects to `/ui/` (307). If the web assets aren't found
+  in the wheel (custom build, etc.), `/` falls back to a minimal JSON
+  health response so scripted clients don't break.
+
 ## [0.2.0] - 2026-04-22
 
 ### Added

{pycentauri-0.2.0 → pycentauri-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycentauri
-Version: 0.2.0
+Version: 0.3.1
 Summary: Python client and MCP server for Elegoo Centauri Carbon 3D printers
 Project-URL: Homepage, https://github.com/bjan/pycentauri
 Project-URL: Repository, https://github.com/bjan/pycentauri
@@ -52,7 +52,7 @@ Python client, CLI, and MCP server for the [Elegoo Centauri
 Carbon](https://www.elegoo.com/) 3D printer.
 
 `pycentauri` speaks the printer's native SDCP v3 protocol over its local
-WebSocket (port 3030) — no cloud account required. It exposes four surfaces:
+WebSocket (port 3030) — no cloud account required. It exposes five surfaces:
 
 1. An **async Python library** for direct integration.
 2. A **`centauri` CLI** for quick status checks, snapshots, and control.
@@ -60,6 +60,8 @@ WebSocket (port 3030) — no cloud account required. It exposes four surfaces:
    MCP-compatible client) can monitor and drive the printer as a tool.
 4. An **HTTP + SSE server** for dashboards, reverse-proxy integration, and
    anything that wants a plain REST API.
+5. A **built-in web UI** (dark theme, mobile-friendly) served at `/ui/` by
+   the HTTP server — live webcam, progress, temperatures, and control.
 
 > **Status:** alpha. The protocol has been reverse-engineered from the official
 > [`elegoo-link`](https://github.com/ELEGOO-3D/elegoo-link) C++ SDK and the
@@ -137,10 +139,13 @@ centauri server --host 192.168.1.209 --bind 0.0.0.0 --port 8787 --enable-control
 
 | Method | Path | Notes |
 |---|---|---|
-| `GET` | `/` | Health + version |
+| `GET` | `/` | Redirects to `/ui/` |
+| `GET` | `/ui/` | Built-in web dashboard |
+| `GET` | `/api/info` | Health + version (JSON) |
 | `GET` | `/status` | Latest status push (cached; updates every ~5s) |
 | `GET` | `/attributes` | Printer attributes |
 | `GET` | `/snapshot` | `image/jpeg` response |
+| `GET` | `/stream` | MJPEG stream proxied from the printer (embeds in `<img>`) |
 | `GET` | `/discover` | LAN scan |
 | `GET` | `/events/status` | Server-Sent Events stream of pushes |
 | `POST` | `/print/start` | Body: `{"filename": "cube.gcode"}`. Requires `--enable-control`. |

{pycentauri-0.2.0 → pycentauri-0.3.1}/README.md

@@ -4,7 +4,7 @@ Python client, CLI, and MCP server for the [Elegoo Centauri
 Carbon](https://www.elegoo.com/) 3D printer.
 
 `pycentauri` speaks the printer's native SDCP v3 protocol over its local
-WebSocket (port 3030) — no cloud account required. It exposes four surfaces:
+WebSocket (port 3030) — no cloud account required. It exposes five surfaces:
 
 1. An **async Python library** for direct integration.
 2. A **`centauri` CLI** for quick status checks, snapshots, and control.
@@ -12,6 +12,8 @@ WebSocket (port 3030) — no cloud account required. It exposes four surfaces:
    MCP-compatible client) can monitor and drive the printer as a tool.
 4. An **HTTP + SSE server** for dashboards, reverse-proxy integration, and
    anything that wants a plain REST API.
+5. A **built-in web UI** (dark theme, mobile-friendly) served at `/ui/` by
+   the HTTP server — live webcam, progress, temperatures, and control.
 
 > **Status:** alpha. The protocol has been reverse-engineered from the official
 > [`elegoo-link`](https://github.com/ELEGOO-3D/elegoo-link) C++ SDK and the
@@ -89,10 +91,13 @@ centauri server --host 192.168.1.209 --bind 0.0.0.0 --port 8787 --enable-control
 
 | Method | Path | Notes |
 |---|---|---|
-| `GET` | `/` | Health + version |
+| `GET` | `/` | Redirects to `/ui/` |
+| `GET` | `/ui/` | Built-in web dashboard |
+| `GET` | `/api/info` | Health + version (JSON) |
 | `GET` | `/status` | Latest status push (cached; updates every ~5s) |
 | `GET` | `/attributes` | Printer attributes |
 | `GET` | `/snapshot` | `image/jpeg` response |
+| `GET` | `/stream` | MJPEG stream proxied from the printer (embeds in `<img>`) |
 | `GET` | `/discover` | LAN scan |
 | `GET` | `/events/status` | Server-Sent Events stream of pushes |
 | `POST` | `/print/start` | Body: `{"filename": "cube.gcode"}`. Requires `--enable-control`. |

{pycentauri-0.2.0 → pycentauri-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycentauri"
-version = "0.2.0"
+version = "0.3.1"
 description = "Python client and MCP server for Elegoo Centauri Carbon 3D printers"
 readme = "README.md"
 license = "Apache-2.0"
@@ -58,6 +58,9 @@ Changelog = "https://github.com/bjan/pycentauri/blob/main/CHANGELOG.md"
 [tool.hatch.build.targets.wheel]
 packages = ["src/pycentauri"]
 
+[tool.hatch.build.targets.sdist]
+include = ["src/pycentauri", "tests", "README.md", "LICENSE", "CHANGELOG.md"]
+
 [tool.ruff]
 line-length = 100
 target-version = "py310"

{pycentauri-0.2.0 → pycentauri-0.3.1}/src/pycentauri/__init__.py

@@ -15,4 +15,4 @@ __all__ = [
     "discover",
 ]
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"

{pycentauri-0.2.0 → pycentauri-0.3.1}/src/pycentauri/server.py

@@ -30,14 +30,18 @@ import json
 import logging
 from collections.abc import AsyncIterator
 from contextlib import asynccontextmanager
+from importlib.resources import files as resource_files
 from typing import Any
 
+import httpx
 from fastapi import Depends, FastAPI, HTTPException, Request
-from fastapi.responses import JSONResponse, Response
+from fastapi.responses import JSONResponse, RedirectResponse, Response, StreamingResponse
+from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel, Field
 from sse_starlette.sse import EventSourceResponse
 
 from pycentauri import __version__
+from pycentauri.camera import CAMERA_PATH, CAMERA_PORT
 from pycentauri.client import ControlDisabledError, Printer, PrinterError
 from pycentauri.discovery import DiscoveredPrinter
 from pycentauri.discovery import discover as lan_discover
@@ -208,17 +212,6 @@ def create_app(
         lifespan=lifespan,
     )
 
-    @app.get("/", tags=["meta"])
-    async def root(manager: PrinterManager = Depends(get_manager)) -> dict[str, Any]:
-        return {
-            "service": "pycentauri",
-            "version": __version__,
-            "printer_host": manager.host,
-            "mainboard_id": manager._mainboard_id,
-            "connected": manager._printer is not None and not manager._printer._closed,
-            "enable_control": manager.enable_control,
-        }
-
     @app.get("/status", tags=["read"])
     async def status_endpoint(
         manager: PrinterManager = Depends(get_manager),
@@ -282,6 +275,38 @@ def create_app(
             headers={"Cache-Control": "no-store"},
         )
 
+    @app.get("/stream", tags=["read"])
+    async def stream_endpoint(
+        manager: PrinterManager = Depends(get_manager),
+    ) -> StreamingResponse:
+        """Proxy the printer's MJPEG stream.
+
+        The printer serves ``multipart/x-mixed-replace`` on port 3031.
+        Browsers can render this directly in an ``<img src=...>`` tag. We
+        proxy it through the API server so the UI never needs to know the
+        printer's IP and so cross-origin isn't an issue.
+        """
+        url = f"http://{manager.host}:{CAMERA_PORT}{CAMERA_PATH}"
+        client = httpx.AsyncClient(timeout=None)
+
+        async def body() -> AsyncIterator[bytes]:
+            try:
+                async with client.stream("GET", url) as upstream:
+                    if upstream.status_code != 200:
+                        return
+                    async for chunk in upstream.aiter_raw():
+                        yield chunk
+            except Exception as err:
+                log.warning("MJPEG proxy error: %r", err)
+            finally:
+                with contextlib.suppress(Exception):
+                    await client.aclose()
+
+        return StreamingResponse(
+            body(),
+            media_type="multipart/x-mixed-replace; boundary=--foo",
+        )
+
     @app.get("/discover", tags=["read"])
     async def discover_endpoint() -> list[dict[str, Any]]:
         found: list[DiscoveredPrinter] = await lan_discover(timeout=2.0, retries=2)
@@ -317,6 +342,45 @@ def create_app(
 
         return EventSourceResponse(gen())
 
+    # --- Meta / health ------------------------------------------------------
+
+    @app.get("/api/info", tags=["meta"])
+    async def api_info(
+        manager: PrinterManager = Depends(get_manager),
+    ) -> dict[str, Any]:
+        return {
+            "service": "pycentauri",
+            "version": __version__,
+            "printer_host": manager.host,
+            "mainboard_id": manager._mainboard_id,
+            "connected": manager._printer is not None and not manager._printer._closed,
+            "enable_control": manager.enable_control,
+        }
+
+    # --- Static web UI ------------------------------------------------------
+
+    _web_root = resource_files("pycentauri").joinpath("web")
+    if _web_root.is_dir():
+        app.mount("/ui", StaticFiles(directory=str(_web_root), html=True), name="ui")
+
+        @app.get("/", include_in_schema=False)
+        async def root_redirect() -> RedirectResponse:
+            return RedirectResponse(url="/ui/", status_code=307)
+    else:
+
+        @app.get("/", tags=["meta"])
+        async def root_fallback(
+            manager: PrinterManager = Depends(get_manager),
+        ) -> dict[str, Any]:
+            # Web UI assets not present — fall back to JSON health.
+            return {
+                "service": "pycentauri",
+                "version": __version__,
+                "printer_host": manager.host,
+                "enable_control": manager.enable_control,
+                "ui": "not installed",
+            }
+
     if not enable_control:
         return app
 

pycentauri-0.3.1/src/pycentauri/web/app.js

@@ -0,0 +1,282 @@
+// pycentauri web console
+// Consumes /api/info, /status, /events/status (SSE), /attributes.
+// Posts to /print/{pause,resume,stop} when --enable-control is on.
+
+const $ = (id) => document.getElementById(id);
+
+// PrintInfo.Status → display label + semantic class.
+// Codes decoded from CentauriLink + official elegoo-link + live observation.
+const PRINT_STATUS = {
+  0:  { label: "IDLE",       cls: "state-idle" },
+  1:  { label: "HOMING",     cls: "state-printing" },
+  2:  { label: "DROPPING",   cls: "state-printing" },
+  3:  { label: "EXPOSING",   cls: "state-printing" },
+  4:  { label: "LIFTING",    cls: "state-printing" },
+  5:  { label: "PAUSING",    cls: "state-paused" },
+  6:  { label: "PAUSED",     cls: "state-paused" },
+  7:  { label: "STOPPING",   cls: "state-stopped" },
+  8:  { label: "STOPPED",    cls: "state-stopped" },
+  9:  { label: "COMPLETED",  cls: "state-completed" },
+  10: { label: "CHECKING",   cls: "state-printing" },
+  12: { label: "PREPARING",  cls: "state-printing" },
+  13: { label: "PRINTING",   cls: "state-printing" },
+  18: { label: "RESUMED",    cls: "state-printing" },
+};
+
+function fmtSeconds(s) {
+  if (s == null || Number.isNaN(+s)) return "—";
+  s = Math.max(0, Math.round(+s));
+  const h = Math.floor(s / 3600);
+  const m = Math.floor((s % 3600) / 60);
+  const sec = s % 60;
+  if (h > 0) return `${h}h ${m.toString().padStart(2, "0")}m`;
+  if (m > 0) return `${m}m ${sec.toString().padStart(2, "0")}s`;
+  return `${sec}s`;
+}
+
+function fmtTemp(v, padTo = "---.-") {
+  if (v == null || Number.isNaN(+v)) return padTo;
+  return (+v).toFixed(1);
+}
+
+function fmtCoord(v) {
+  if (v == null || Number.isNaN(+v)) return "---.--";
+  return (+v).toFixed(2).padStart(6, " ");
+}
+
+function tempPct(actual, target) {
+  if (actual == null || target == null || target <= 0) return 0;
+  return Math.min(100, Math.max(0, (actual / target) * 100));
+}
+
+function setStatusPill(kind, label) {
+  const pill = $("status-pill");
+  pill.classList.remove("warn", "err");
+  if (kind === "warn") pill.classList.add("warn");
+  if (kind === "err")  pill.classList.add("err");
+  $("status-text").textContent = label;
+}
+
+// ---------------------------------------------------------------------------
+
+async function loadInfo() {
+  try {
+    const r = await fetch("/api/info");
+    if (!r.ok) throw new Error(`HTTP ${r.status}`);
+    const info = await r.json();
+
+    $("version").textContent = info.version || "—";
+    $("host").textContent = info.printer_host || "—";
+    $("mainboard").textContent = info.mainboard_id || "—";
+    $("mainboard").title = info.mainboard_id || "";
+
+    if (info.enable_control) $("controls").hidden = false;
+
+    try {
+      const attrs = await (await fetch("/attributes")).json();
+      $("printer-name").textContent = (attrs.machine_name || attrs.name || "Centauri Carbon").toUpperCase();
+      $("firmware").textContent = attrs.firmware_version ? `FW ${attrs.firmware_version}` : "";
+    } catch (_) { /* firmware may not push in idle */ }
+
+    if (info.connected) {
+      setStatusPill("ok", "LINK OK");
+    } else {
+      setStatusPill("warn", "LINK DOWN");
+    }
+  } catch (e) {
+    setStatusPill("err", "SRV OFFLINE");
+    console.warn("loadInfo failed:", e);
+  }
+}
+
+function renderStatus(raw) {
+  const pi = raw.PrintInfo || {};
+  const pstatus = pi.Status;
+  const filename = pi.Filename;
+
+  // Job name
+  $("filename").textContent = filename || "— · AWAITING ·";
+
+  // Progress
+  const progress = pi.Progress;
+  const pct = (progress != null) ? Math.max(0, Math.min(100, +progress)) : 0;
+  $("progress-bar").style.width = pct + "%";
+  $("progress-label").textContent = (progress != null) ? `${pct}%` : "—";
+
+  // State word + code
+  const info = PRINT_STATUS[pstatus];
+  const sw = $("print-status");
+  const sc = $("print-status-code");
+  sw.classList.remove("state-idle", "state-printing", "state-paused", "state-stopped", "state-completed");
+  if (info) {
+    sw.textContent = info.label;
+    sw.classList.add(info.cls);
+  } else if (pstatus != null) {
+    sw.textContent = `CODE·${pstatus}`;
+  } else {
+    sw.textContent = "—";
+  }
+  sc.textContent = (pstatus != null) ? String(pstatus).padStart(2, "0") : "--";
+
+  // Layer
+  $("layer").textContent = (pi.CurrentLayer != null && pi.TotalLayer)
+    ? `${pi.CurrentLayer} / ${pi.TotalLayer}`
+    : "—";
+
+  // Times (CurrentTicks / TotalTicks are seconds on CC firmware)
+  const elapsed = pi.CurrentTicks;
+  const total = pi.TotalTicks;
+  $("elapsed").textContent = fmtSeconds(elapsed);
+  $("remaining").textContent = (total != null && elapsed != null)
+    ? fmtSeconds(total - elapsed) : "—";
+
+  // Speed %
+  $("speed").textContent = (pi.PrintSpeedPct != null) ? `${pi.PrintSpeedPct}%` : "—";
+
+  // Temperatures
+  const noz  = raw.TempOfNozzle, nozT = raw.TempTargetNozzle;
+  const bed  = raw.TempOfHotbed, bedT = raw.TempTargetHotbed;
+  const cham = raw.TempOfBox,    chamT = raw.TempTargetBox;
+  $("t-nozzle").textContent        = fmtTemp(noz);
+  $("t-nozzle-target").textContent = (nozT != null) ? String(Math.round(+nozT)) : "---";
+  $("t-nozzle-bar").style.width    = tempPct(noz, nozT) + "%";
+  $("t-bed").textContent           = fmtTemp(bed);
+  $("t-bed-target").textContent    = (bedT != null) ? String(Math.round(+bedT)) : "---";
+  $("t-bed-bar").style.width       = tempPct(bed, bedT) + "%";
+  $("t-chamber").textContent       = fmtTemp(cham);
+  $("t-chamber-target").textContent = (chamT != null) ? String(Math.round(+chamT)) : "---";
+  // Chamber often targets 0; show the actual vs a reference of 50°C so the bar conveys warmth.
+  $("t-chamber-bar").style.width   = Math.min(100, Math.max(0, (+(cham ?? 0) / 50) * 100)) + "%";
+
+  // Coords "x,y,z"
+  if (typeof raw.CurrenCoord === "string") {
+    const [x, y, z] = raw.CurrenCoord.split(",");
+    $("pos-x").textContent = fmtCoord(x);
+    $("pos-y").textContent = fmtCoord(y);
+    $("pos-z").textContent = fmtCoord(z);
+  }
+
+  // Z offset
+  if (raw.ZOffset != null) $("z-offset").textContent = (+raw.ZOffset).toFixed(3);
+
+  // Fans
+  const fans = raw.CurrentFanSpeed || {};
+  const setFan = (id, key) => {
+    const v = fans[key];
+    $(id).textContent = (v != null) ? `${v}%` : "—";
+  };
+  setFan("fan-model", "ModelFan");
+  setFan("fan-aux",   "AuxiliaryFan");
+  setFan("fan-box",   "BoxFan");
+
+  setStatusPill("ok", "LINK OK");
+}
+
+async function pollOnce() {
+  try {
+    const r = await fetch("/status");
+    if (!r.ok) throw new Error("HTTP " + r.status);
+    const body = await r.json();
+    if (body.raw) renderStatus(body.raw);
+  } catch (e) {
+    setStatusPill("warn", "LINK WAIT");
+    console.warn("poll failed:", e);
+  }
+}
+
+function connectSSE() {
+  let src;
+  try { src = new EventSource("/events/status"); }
+  catch (_) {
+    setStatusPill("warn", "SSE N/A");
+    setInterval(pollOnce, 3000);
+    return;
+  }
+  src.addEventListener("status", (ev) => {
+    try { renderStatus(JSON.parse(ev.data)); } catch (_) {}
+  });
+  src.onerror = () => {
+    setStatusPill("warn", "LINK WAIT");
+    setTimeout(pollOnce, 2000);
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Controls
+
+function setMsg(text, kind) {
+  const el = $("ctrl-msg");
+  el.classList.remove("ok", "warn", "err");
+  if (kind) el.classList.add(kind);
+  el.textContent = text;
+}
+
+async function doAction(label, path, confirmMsg) {
+  if (confirmMsg && !confirm(confirmMsg)) return;
+  setMsg(`» ${label}…`);
+  const btns = document.querySelectorAll(".controls button");
+  for (const b of btns) b.disabled = true;
+  try {
+    const r = await fetch(path, { method: "POST" });
+    if (!r.ok) throw new Error(`HTTP ${r.status} — ${await r.text()}`);
+    setMsg(`✓ ${label} acknowledged`, "ok");
+  } catch (e) {
+    setMsg(`✗ ${label}: ${e.message}`, "err");
+  } finally {
+    setTimeout(() => {
+      for (const b of btns) b.disabled = false;
+    }, 800);
+  }
+}
+
+function wireControls() {
+  $("btn-pause")?.addEventListener("click", () =>
+    doAction("PAUSE", "/print/pause", "Pause the current print?")
+  );
+  $("btn-resume")?.addEventListener("click", () =>
+    doAction("RESUME", "/print/resume")
+  );
+  $("btn-stop")?.addEventListener("click", () =>
+    doAction("STOP", "/print/stop",
+      "Stop the current print?\n\nThis cannot be undone.")
+  );
+
+  // Keyboard shortcuts when controls are visible.
+  document.addEventListener("keydown", (ev) => {
+    if ($("controls").hidden) return;
+    if (ev.target && /^(INPUT|TEXTAREA|SELECT)$/.test(ev.target.tagName)) return;
+    if (ev.key === "F1") { ev.preventDefault(); $("btn-pause").click(); }
+    if (ev.key === "F2") { ev.preventDefault(); $("btn-resume").click(); }
+    if (ev.key === "F3") { ev.preventDefault(); $("btn-stop").click(); }
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Webcam resilience — if the MJPEG stream stalls, reload it.
+
+function wireWebcamKeepalive() {
+  const img = $("webcam");
+  let lastChange = Date.now();
+  let loads = 0;
+  img.addEventListener("load", () => { lastChange = Date.now(); loads++; });
+  img.addEventListener("error", () => {
+    setTimeout(() => { img.src = `/stream?t=${Date.now()}`; }, 2000);
+  });
+  setInterval(() => {
+    if (Date.now() - lastChange > 15000) {
+      img.src = `/stream?t=${Date.now()}`;
+      lastChange = Date.now();
+    }
+  }, 5000);
+}
+
+// ---------------------------------------------------------------------------
+
+(async function main() {
+  wireControls();
+  wireWebcamKeepalive();
+  await loadInfo();
+  await pollOnce();
+  connectSSE();
+  setInterval(loadInfo, 60000);
+})();