pycentauri 0.2.0__tar.gz → 0.3.0__tar.gz

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

@@ -6,6 +6,24 @@ Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [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.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycentauri
-Version: 0.2.0
+Version: 0.3.0
 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.0}/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.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycentauri"
-version = "0.2.0"
+version = "0.3.0"
 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.0}/src/pycentauri/__init__.py

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

{pycentauri-0.2.0 → pycentauri-0.3.0}/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.0/src/pycentauri/web/app.js

@@ -0,0 +1,179 @@
+// pycentauri web UI
+// Consumes /api/info, /status (one-shot), /events/status (SSE), and POSTs to
+// /print/{pause,resume,stop} when control is enabled.
+
+const $ = (id) => document.getElementById(id);
+
+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-idle" },
+  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) {
+  return (v == null || Number.isNaN(v)) ? "—" : v.toFixed(1);
+}
+
+async function loadInfo() {
+  try {
+    const r = await fetch("/api/info");
+    if (!r.ok) return;
+    const info = await r.json();
+    $("version").textContent = info.version || "—";
+    $("host").textContent = info.printer_host || "—";
+    $("mainboard").textContent = 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";
+      $("firmware").textContent = attrs.firmware_version ? `· ${attrs.firmware_version}` : "";
+    } catch (_) { /* printer may still be warming up */ }
+  } catch (e) {
+    console.warn("loadInfo failed:", e);
+  }
+}
+
+function renderStatus(raw) {
+  // raw is the printer's Status dict (SDCP payload).
+  const pi = raw.PrintInfo || {};
+  const pstatus = pi.Status;
+  const filename = pi.Filename || "—";
+
+  $("filename").textContent = filename;
+
+  const progress = pi.Progress;
+  $("progress-bar").style.width = (progress != null ? progress : 0) + "%";
+  const layerStr = pi.CurrentLayer != null && pi.TotalLayer
+    ? ` · layer ${pi.CurrentLayer}/${pi.TotalLayer}`
+    : "";
+  $("progress-label").textContent = (progress != null ? progress + "%" : "—") + layerStr;
+
+  const info = PRINT_STATUS[pstatus];
+  const ps = $("print-status");
+  ps.textContent = info ? info.label : (pstatus != null ? `code ${pstatus}` : "—");
+  ps.className = info ? info.cls : "";
+
+  $("layer").textContent = (pi.CurrentLayer != null && pi.TotalLayer)
+    ? `${pi.CurrentLayer}/${pi.TotalLayer}` : "—";
+
+  // SDCP Ticks are reported in seconds on this firmware.
+  const elapsed = pi.CurrentTicks;
+  const total = pi.TotalTicks;
+  $("elapsed").textContent = fmtSeconds(elapsed);
+  $("remaining").textContent = (total != null && elapsed != null)
+    ? fmtSeconds(total - elapsed) : "—";
+
+  // Temperatures — firmware gives scalars for actuals and TempTarget* for targets.
+  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 = fmtTemp(nozT);
+  $("t-bed").textContent           = fmtTemp(bed);
+  $("t-bed-target").textContent    = fmtTemp(bedT);
+  $("t-chamber").textContent       = fmtTemp(cham);
+  $("t-chamber-target").textContent = fmtTemp(chamT);
+
+  if (raw.CurrenCoord) $("position").textContent = raw.CurrenCoord;
+  if (raw.ZOffset != null) $("z-offset").textContent = raw.ZOffset.toFixed(3);
+  if (raw.CurrentFanSpeed) {
+    $("fans").textContent = Object.entries(raw.CurrentFanSpeed)
+      .map(([k, v]) => `${k}=${v}%`).join("  ");
+  }
+
+  $("status-dot").className = "dot 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) {
+    $("status-dot").className = "dot err";
+    console.warn("poll failed:", e);
+  }
+}
+
+function connectSSE() {
+  let src;
+  try {
+    src = new EventSource("/events/status");
+  } catch (e) {
+    $("status-dot").className = "dot warn";
+    setInterval(pollOnce, 3000);
+    return;
+  }
+  src.addEventListener("status", (ev) => {
+    try { renderStatus(JSON.parse(ev.data)); } catch (_) {}
+  });
+  src.onerror = () => {
+    $("status-dot").className = "dot warn";
+    // EventSource auto-reconnects; keep a slow poll as a safety net.
+    setTimeout(pollOnce, 2000);
+  };
+}
+
+// --- Controls (only wired when visible) -----------------------------------
+
+async function doAction(name, path) {
+  const msg = $("ctrl-msg");
+  msg.textContent = `${name}…`;
+  for (const b of document.querySelectorAll(".controls button")) b.disabled = true;
+  try {
+    const r = await fetch(path, { method: "POST" });
+    if (!r.ok) throw new Error(`HTTP ${r.status}: ${await r.text()}`);
+    msg.textContent = `${name} ✓`;
+  } catch (e) {
+    msg.textContent = `${name} failed — ${e.message}`;
+  } finally {
+    setTimeout(() => {
+      for (const b of document.querySelectorAll(".controls button")) b.disabled = false;
+    }, 800);
+  }
+}
+
+function wireControls() {
+  $("btn-pause").addEventListener("click", () => {
+    if (confirm("Pause the current print?")) doAction("pause", "/print/pause");
+  });
+  $("btn-resume").addEventListener("click", () => doAction("resume", "/print/resume"));
+  $("btn-stop").addEventListener("click", () => {
+    if (confirm("Stop the current print? This cannot be undone.")) doAction("stop", "/print/stop");
+  });
+}
+
+// --- Boot ------------------------------------------------------------------
+
+(async function main() {
+  await loadInfo();
+  wireControls();
+  await pollOnce();
+  connectSSE();
+  // Safety net: refresh info every 60s in case the server was restarted.
+  setInterval(loadInfo, 60000);
+})();

pycentauri-0.3.0/src/pycentauri/web/index.html

@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>pycentauri</title>
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <header>
+    <h1>pycentauri</h1>
+    <div id="header-meta">
+      <span id="printer-name">…</span>
+      <span id="firmware"></span>
+      <span id="status-dot" class="dot" title="Connection state"></span>
+    </div>
+  </header>
+
+  <main>
+    <section class="card webcam">
+      <img id="webcam" alt="Webcam" src="/stream">
+      <a class="snap-link" href="/snapshot" download="snapshot.jpg">Snapshot</a>
+    </section>
+
+    <section class="card job">
+      <div id="filename" class="filename">—</div>
+      <div class="progress-wrap">
+        <div id="progress-bar" class="progress-bar"></div>
+        <span id="progress-label" class="progress-label">—</span>
+      </div>
+      <div class="job-meta">
+        <div><span class="k">state</span><span id="print-status">—</span></div>
+        <div><span class="k">layer</span><span id="layer">—</span></div>
+        <div><span class="k">elapsed</span><span id="elapsed">—</span></div>
+        <div><span class="k">remaining</span><span id="remaining">—</span></div>
+      </div>
+    </section>
+
+    <section class="temps">
+      <div class="card temp">
+        <div class="k">nozzle</div>
+        <div class="t"><span id="t-nozzle">—</span><span class="unit">°C</span></div>
+        <div class="sub">target <span id="t-nozzle-target">—</span>°C</div>
+      </div>
+      <div class="card temp">
+        <div class="k">bed</div>
+        <div class="t"><span id="t-bed">—</span><span class="unit">°C</span></div>
+        <div class="sub">target <span id="t-bed-target">—</span>°C</div>
+      </div>
+      <div class="card temp">
+        <div class="k">chamber</div>
+        <div class="t"><span id="t-chamber">—</span><span class="unit">°C</span></div>
+        <div class="sub">target <span id="t-chamber-target">—</span>°C</div>
+      </div>
+    </section>
+
+    <section id="controls" class="card controls" hidden>
+      <h2>Control</h2>
+      <div class="btn-row">
+        <button id="btn-pause"  class="btn warn">Pause</button>
+        <button id="btn-resume" class="btn">Resume</button>
+        <button id="btn-stop"   class="btn danger">Stop</button>
+      </div>
+      <div id="ctrl-msg" class="ctrl-msg"></div>
+    </section>
+
+    <section class="card position">
+      <div class="row"><span class="k">position</span><span id="position">—</span></div>
+      <div class="row"><span class="k">z-offset</span><span id="z-offset">—</span></div>
+      <div class="row"><span class="k">fans</span><span id="fans">—</span></div>
+      <div class="row"><span class="k">mainboard</span><span id="mainboard">—</span></div>
+    </section>
+  </main>
+
+  <footer>
+    <span>pycentauri <span id="version">—</span></span>
+    <span>·</span>
+    <span id="host">—</span>
+    <span>·</span>
+    <a href="/docs">API docs</a>
+  </footer>
+
+  <script src="app.js"></script>
+</body>
+</html>

pycentauri-0.3.0/src/pycentauri/web/styles.css

@@ -0,0 +1,257 @@
+:root {
+  --bg: #0d0f12;
+  --bg-card: #171a1f;
+  --bg-card-alt: #1f242b;
+  --border: #262d36;
+  --fg: #e7ecf2;
+  --fg-muted: #8a94a3;
+  --accent: #4fb3ff;
+  --accent-warn: #f3b54a;
+  --accent-danger: #ef5b5b;
+  --accent-ok: #56d28a;
+  --font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  --font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
+}
+
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; }
+body {
+  background: var(--bg);
+  color: var(--fg);
+  font-family: var(--font);
+  font-size: 14px;
+  line-height: 1.45;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+}
+
+header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 14px 20px;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-card);
+}
+header h1 {
+  font-size: 16px;
+  font-weight: 600;
+  margin: 0;
+  letter-spacing: 0.02em;
+}
+#header-meta {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  font-size: 12px;
+  color: var(--fg-muted);
+}
+#header-meta #printer-name { color: var(--fg); }
+.dot {
+  width: 9px; height: 9px; border-radius: 50%;
+  background: var(--fg-muted);
+  display: inline-block;
+  transition: background .2s;
+}
+.dot.ok     { background: var(--accent-ok); box-shadow: 0 0 6px var(--accent-ok); }
+.dot.warn   { background: var(--accent-warn); }
+.dot.err    { background: var(--accent-danger); }
+
+main {
+  flex: 1;
+  padding: 16px;
+  display: grid;
+  gap: 16px;
+  grid-template-columns: 1fr;
+  max-width: 1200px;
+  margin: 0 auto;
+  width: 100%;
+}
+
+@media (min-width: 900px) {
+  main {
+    grid-template-columns: 2fr 1fr;
+    grid-template-areas:
+      "webcam    job"
+      "webcam    temps"
+      "controls  temps"
+      "position  position";
+  }
+  .webcam   { grid-area: webcam; }
+  .job      { grid-area: job; }
+  .temps    { grid-area: temps; }
+  .controls { grid-area: controls; }
+  .position { grid-area: position; }
+}
+
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 14px 16px;
+}
+
+.card h2 {
+  margin: 0 0 10px;
+  font-size: 13px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--fg-muted);
+}
+
+.webcam {
+  position: relative;
+  padding: 0;
+  overflow: hidden;
+  aspect-ratio: 16 / 9;
+  background: #000;
+}
+.webcam img {
+  width: 100%;
+  height: 100%;
+  object-fit: contain;
+  display: block;
+}
+.snap-link {
+  position: absolute;
+  top: 10px;
+  right: 10px;
+  padding: 4px 10px;
+  background: rgba(0,0,0,0.55);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  font-size: 12px;
+  text-decoration: none;
+}
+.snap-link:hover { background: rgba(0,0,0,0.75); }
+
+.filename {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  color: var(--fg);
+  margin-bottom: 10px;
+  word-break: break-all;
+}
+
+.progress-wrap {
+  position: relative;
+  height: 22px;
+  background: var(--bg-card-alt);
+  border-radius: 5px;
+  overflow: hidden;
+  margin-bottom: 14px;
+}
+.progress-bar {
+  height: 100%;
+  width: 0%;
+  background: linear-gradient(90deg, #3a9bdc, var(--accent));
+  transition: width .6s ease-out;
+}
+.progress-label {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 12px;
+  font-variant-numeric: tabular-nums;
+  color: var(--fg);
+  mix-blend-mode: difference;
+}
+
+.job-meta {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 6px 16px;
+  font-size: 12px;
+}
+.job-meta .k { color: var(--fg-muted); margin-right: 8px; }
+
+.temps {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 10px;
+}
+.temp { padding: 12px; text-align: center; }
+.temp .k {
+  display: block;
+  color: var(--fg-muted);
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  margin-bottom: 6px;
+}
+.temp .t {
+  font-size: 22px;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+  font-family: var(--font-mono);
+}
+.temp .t .unit {
+  font-size: 13px;
+  color: var(--fg-muted);
+  margin-left: 2px;
+}
+.temp .sub { font-size: 11px; color: var(--fg-muted); margin-top: 2px; }
+
+.controls .btn-row {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.btn {
+  padding: 8px 16px;
+  background: var(--bg-card-alt);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  font-size: 13px;
+  font-family: var(--font);
+  cursor: pointer;
+  transition: background .15s, border-color .15s;
+}
+.btn:hover:not(:disabled) { background: #262d36; border-color: #3b4552; }
+.btn:disabled { opacity: 0.45; cursor: not-allowed; }
+.btn.warn   { border-color: #6a561c; color: var(--accent-warn); }
+.btn.danger { border-color: #6b2c2c; color: var(--accent-danger); }
+.ctrl-msg {
+  margin-top: 10px;
+  font-size: 12px;
+  color: var(--fg-muted);
+  font-family: var(--font-mono);
+  min-height: 1.2em;
+}
+
+.position .row {
+  display: flex;
+  justify-content: space-between;
+  gap: 10px;
+  padding: 4px 0;
+  border-bottom: 1px solid var(--border);
+  font-size: 12px;
+  font-family: var(--font-mono);
+}
+.position .row:last-child { border-bottom: none; }
+.position .k { color: var(--fg-muted); }
+
+footer {
+  padding: 10px 20px;
+  text-align: center;
+  color: var(--fg-muted);
+  font-size: 11px;
+  border-top: 1px solid var(--border);
+  display: flex;
+  justify-content: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+footer a { color: var(--accent); text-decoration: none; }
+footer a:hover { text-decoration: underline; }
+
+/* Print status codes — mapped in JS to a human label + color */
+.state-printing { color: var(--accent-ok); }
+.state-paused   { color: var(--accent-warn); }
+.state-stopped  { color: var(--accent-danger); }
+.state-idle     { color: var(--fg-muted); }

{pycentauri-0.2.0 → pycentauri-0.3.0}/tests/test_server.py

@@ -32,12 +32,17 @@ async def test_read_endpoints(monkeypatch: pytest.MonkeyPatch) -> None:
     # Mimic the lifespan manager manually: the async-context machinery
     # under httpx.AsyncClient doesn't drive lifespan, so do it ourselves.
     async with app.router.lifespan_context(app), await _asgi_client(app) as client:
-        r = await client.get("/")
+        # /api/info is the JSON health endpoint; / redirects to /ui/.
+        r = await client.get("/api/info")
         assert r.status_code == 200
         body = r.json()
         assert body["service"] == "pycentauri"
         assert body["printer_host"] == "127.0.0.1"
 
+        r = await client.get("/ui/", follow_redirects=False)
+        assert r.status_code == 200
+        assert "<!DOCTYPE html>" in r.text
+
         r = await client.get("/status")
         assert r.status_code == 200
         s = r.json()

pycentauri-0.2.0/.github/workflows/ci.yml

@@ -1,42 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-  workflow_dispatch:
-
-jobs:
-  test:
-    name: "test (py${{ matrix.python-version }}, ${{ matrix.os }})"
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest]
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[mcp,dev]"
-
-      - name: Ruff check
-        run: ruff check .
-
-      - name: Ruff format check
-        run: ruff format --check .
-
-      - name: Mypy
-        run: mypy src
-
-      - name: Pytest
-        run: pytest --cov=pycentauri --cov-report=term-missing

pycentauri-0.2.0/.github/workflows/publish.yml

@@ -1,48 +0,0 @@
-name: Publish to PyPI
-
-on:
-  push:
-    tags: ["v*"]
-  workflow_dispatch:
-
-jobs:
-  build:
-    name: Build sdist & wheel
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install build tooling
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
-
-      - name: Build
-        run: python -m build
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: dist/
-
-  publish:
-    name: Publish to PyPI
-    needs: build
-    runs-on: ubuntu-latest
-    environment: release
-    permissions:
-      id-token: write  # required for PyPI trusted publishing (OIDC)
-
-    steps:
-      - uses: actions/download-artifact@v4
-        with:
-          name: dist
-          path: dist/
-
-      - name: Publish
-        uses: pypa/gh-action-pypi-publish@release/v1

pycentauri-0.2.0/CONTRIBUTING.md

@@ -1,56 +0,0 @@
-# Contributing to pycentauri
-
-Thanks for your interest. This is a community-driven library for the Elegoo
-Centauri Carbon; contributions of every size are welcome.
-
-## Dev setup
-
-```sh
-git clone https://github.com/bjan/pycentauri
-cd pycentauri
-python -m venv .venv
-. .venv/bin/activate
-pip install -e ".[mcp,dev]"
-```
-
-## Running checks
-
-```sh
-ruff check .
-ruff format --check .
-mypy src
-pytest
-```
-
-## Integration tests against a real printer
-
-Unit tests are fully offline. To exercise the client against a real Centauri
-Carbon on your LAN:
-
-```sh
-PYCENTAURI_TEST_HOST=192.168.1.x pytest tests/integration
-```
-
-These are skipped by default in CI.
-
-## Protocol references
-
-The Centauri Carbon speaks Elegoo's SDCP v3 over a WebSocket on port 3030.
-Two projects helped decode the wire protocol:
-
-- [`ELEGOO-3D/elegoo-link`](https://github.com/ELEGOO-3D/elegoo-link) — the
-  official C++ SDK; `src/lan/adapters/elegoo_fdm_cc/` is the authoritative
-  reference for the original Centauri Carbon.
-- [`CentauriLink/Centauri-Link`](https://github.com/CentauriLink/Centauri-Link)
-  — a Kivy desktop/mobile GUI; its `main.py` documents the SDCP envelope and
-  subscription dance in detail.
-
-When adding a new command code, update `pycentauri/sdcp.py` `Cmd` with a
-comment linking to the upstream reference.
-
-## Pull requests
-
-- Keep changes small and focused.
-- Add unit tests for any new parsing or envelope logic.
-- Run `ruff format` before submitting.
-- Update `CHANGELOG.md` under `[Unreleased]`.

pycentauri-0.2.0/examples/snapshot.py

@@ -1,22 +0,0 @@
-"""Save a webcam snapshot to a JPEG file."""
-
-from __future__ import annotations
-
-import asyncio
-import sys
-
-from pycentauri import Printer
-
-
-async def main(host: str, out: str) -> None:
-    async with await Printer.connect(host) as printer:
-        jpeg = await printer.snapshot()
-    with open(out, "wb") as f:
-        f.write(jpeg)
-    print(f"wrote {len(jpeg)} bytes to {out}")
-
-
-if __name__ == "__main__":
-    host = sys.argv[1] if len(sys.argv) > 1 else "192.168.1.209"
-    out = sys.argv[2] if len(sys.argv) > 2 else "shot.jpg"
-    asyncio.run(main(host, out))

pycentauri-0.2.0/examples/start_print.py

@@ -1,26 +0,0 @@
-"""Start a print of a file that is already on the printer.
-
-The library refuses write actions unless ``enable_control=True`` is passed
-explicitly. Run the printer's own screen or web UI to confirm the file is
-staged before you call this.
-"""
-
-from __future__ import annotations
-
-import asyncio
-import sys
-
-from pycentauri import Printer
-
-
-async def main(host: str, filename: str) -> None:
-    async with await Printer.connect(host, enable_control=True) as printer:
-        result = await printer.start_print(filename)
-        print("start_print response:", result.inner)
-
-
-if __name__ == "__main__":
-    if len(sys.argv) < 3:
-        print("usage: python start_print.py <host> <filename>", file=sys.stderr)
-        raise SystemExit(2)
-    asyncio.run(main(sys.argv[1], sys.argv[2]))

pycentauri-0.2.0/examples/status_watch.py

@@ -1,27 +0,0 @@
-"""Stream live status pushes from the printer until Ctrl-C."""
-
-from __future__ import annotations
-
-import asyncio
-import contextlib
-import sys
-
-from pycentauri import Printer
-
-
-async def main(host: str) -> None:
-    async with await Printer.connect(host) as printer:
-        async for st in printer.watch():
-            print(
-                f"state={st.print_status or '-':>3}  "
-                f"progress={st.progress or 0:>3}%  "
-                f"nozzle={st.temp_nozzle or 0:5.1f}°C  "
-                f"bed={st.temp_bed or 0:5.1f}°C  "
-                f"file={st.filename or '-'}"
-            )
-
-
-if __name__ == "__main__":
-    host = sys.argv[1] if len(sys.argv) > 1 else "192.168.1.209"
-    with contextlib.suppress(KeyboardInterrupt):
-        asyncio.run(main(host))