pycentauri 0.3.0__tar.gz → 0.3.1__tar.gz

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

@@ -6,6 +6,21 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycentauri
-Version: 0.3.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

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycentauri"
-version = "0.3.0"
+version = "0.3.1"
 description = "Python client and MCP server for Elegoo Centauri Carbon 3D printers"
 readme = "README.md"
 license = "Apache-2.0"

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

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

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);
+})();

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

@@ -0,0 +1,210 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
+  <meta name="theme-color" content="#0b0b0d">
+  <title>pycentauri · console</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Space+Mono:wght@400;700&family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans+Condensed:wght@500;600;700&display=swap">
+  <link rel="stylesheet" href="styles.css">
+  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' fill='%230b0b0d'/%3E%3Ccircle cx='16' cy='16' r='6' fill='%23ffb347'/%3E%3Ccircle cx='16' cy='16' r='10' fill='none' stroke='%23ffb347' stroke-width='1.5' stroke-dasharray='2 3'/%3E%3C/svg%3E">
+</head>
+<body>
+  <div class="bg-grid"  aria-hidden="true"></div>
+  <div class="bg-noise" aria-hidden="true"></div>
+
+  <!-- Upper rail -->
+  <nav class="rail rail-top">
+    <div class="rail-group">
+      <span class="logo">◉ PYCENTAURI</span>
+      <span class="rail-sep">/</span>
+      <span class="rail-ver">v<span id="version">—</span></span>
+    </div>
+    <div class="rail-group">
+      <span class="rail-dim" id="printer-name">—</span>
+      <span class="rail-sep">·</span>
+      <span class="rail-dim"><span id="firmware">—</span></span>
+      <span class="status-pill" id="status-pill">
+        <span class="status-dot"></span>
+        <span id="status-text">LINK</span>
+      </span>
+    </div>
+  </nav>
+
+  <main class="console">
+    <!-- LEFT column — viewport + progress + controls -->
+    <section class="viewport-col">
+
+      <!-- Webcam viewport hero -->
+      <div class="viewport" role="img" aria-label="Live webcam feed">
+        <img id="webcam" src="/stream" alt="">
+        <div class="viewport-corners" aria-hidden="true">
+          <span class="corner tl"></span>
+          <span class="corner tr"></span>
+          <span class="corner bl"></span>
+          <span class="corner br"></span>
+        </div>
+        <div class="viewport-crosshair" aria-hidden="true">
+          <span class="ch ch-h"></span>
+          <span class="ch ch-v"></span>
+          <span class="ch-dot"></span>
+        </div>
+        <div class="viewport-scanline" aria-hidden="true"></div>
+        <div class="viewport-overlay top">
+          <span class="ovl">CAM/01</span>
+          <span class="ovl ovl-rec"><span class="rec-dot"></span>LIVE</span>
+        </div>
+        <div class="viewport-overlay bot">
+          <span class="ovl">MJPEG · :3031</span>
+          <a class="snap-btn" href="/snapshot" download="snapshot.jpg">DL · JPG</a>
+        </div>
+      </div>
+
+      <!-- Job progress strip -->
+      <div class="panel job-panel">
+        <header class="panel-header">
+          <span class="panel-tag">JOB</span>
+          <span class="panel-rule"></span>
+          <span class="panel-idx">02</span>
+        </header>
+        <div class="job-name" id="filename">— · AWAITING ·</div>
+        <div class="job-track">
+          <div class="ruler" aria-hidden="true"></div>
+          <div class="bar">
+            <div class="bar-fill" id="progress-bar"></div>
+            <div class="bar-label">
+              <span id="progress-label">0%</span>
+            </div>
+          </div>
+          <div class="ruler" aria-hidden="true"></div>
+        </div>
+        <dl class="job-stats">
+          <div><dt>LAYER</dt><dd id="layer">—</dd></div>
+          <div><dt>ELAPSED</dt><dd id="elapsed">—</dd></div>
+          <div><dt>ETA</dt><dd id="remaining">—</dd></div>
+          <div><dt>SPEED</dt><dd id="speed">—</dd></div>
+        </dl>
+      </div>
+
+      <!-- Exec / control -->
+      <div class="panel controls" id="controls" hidden>
+        <header class="panel-header">
+          <span class="panel-tag">EXEC</span>
+          <span class="panel-rule"></span>
+          <span class="panel-idx">03</span>
+        </header>
+        <div class="btn-grid">
+          <button id="btn-pause" class="kbd-btn warn" type="button">
+            <span class="kbd-key">F1</span>
+            <span class="kbd-label">PAUSE</span>
+          </button>
+          <button id="btn-resume" class="kbd-btn ok" type="button">
+            <span class="kbd-key">F2</span>
+            <span class="kbd-label">RESUME</span>
+          </button>
+          <button id="btn-stop" class="kbd-btn danger" type="button">
+            <span class="kbd-key">F3</span>
+            <span class="kbd-label">STOP</span>
+          </button>
+        </div>
+        <div class="ctrl-msg" id="ctrl-msg" aria-live="polite"></div>
+      </div>
+    </section>
+
+    <!-- RIGHT column — instruments -->
+    <aside class="instruments-col">
+
+      <!-- State -->
+      <div class="panel state-panel">
+        <header class="panel-header">
+          <span class="panel-tag">STATE</span>
+          <span class="panel-rule"></span>
+          <span class="panel-idx">01</span>
+        </header>
+        <div class="state-row">
+          <span class="state-code" id="print-status-code">--</span>
+          <span class="state-word" id="print-status">IDLE</span>
+        </div>
+      </div>
+
+      <!-- Thermals -->
+      <div class="panel thermal-panel">
+        <header class="panel-header">
+          <span class="panel-tag">THERMAL</span>
+          <span class="panel-rule"></span>
+          <span class="panel-idx">04</span>
+        </header>
+        <div class="gauges">
+          <div class="gauge" data-id="nozzle">
+            <div class="gauge-head">
+              <span class="gauge-label">NZL</span>
+              <span class="gauge-ref">T-01</span>
+            </div>
+            <div class="gauge-val"><span id="t-nozzle">---.-</span><span class="unit">°C</span></div>
+            <div class="gauge-target">SETPOINT · <span id="t-nozzle-target">---</span>°</div>
+            <div class="gauge-bar"><div class="gauge-fill" id="t-nozzle-bar"></div></div>
+          </div>
+          <div class="gauge" data-id="bed">
+            <div class="gauge-head">
+              <span class="gauge-label">BED</span>
+              <span class="gauge-ref">T-02</span>
+            </div>
+            <div class="gauge-val"><span id="t-bed">---.-</span><span class="unit">°C</span></div>
+            <div class="gauge-target">SETPOINT · <span id="t-bed-target">---</span>°</div>
+            <div class="gauge-bar"><div class="gauge-fill" id="t-bed-bar"></div></div>
+          </div>
+          <div class="gauge" data-id="chamber">
+            <div class="gauge-head">
+              <span class="gauge-label">BOX</span>
+              <span class="gauge-ref">T-03</span>
+            </div>
+            <div class="gauge-val"><span id="t-chamber">---.-</span><span class="unit">°C</span></div>
+            <div class="gauge-target">AMBIENT · <span id="t-chamber-target">---</span>°</div>
+            <div class="gauge-bar"><div class="gauge-fill" id="t-chamber-bar"></div></div>
+          </div>
+        </div>
+      </div>
+
+      <!-- Kinematics + fans -->
+      <div class="panel tele-panel">
+        <header class="panel-header">
+          <span class="panel-tag">KINEMATICS</span>
+          <span class="panel-rule"></span>
+          <span class="panel-idx">05</span>
+        </header>
+        <div class="coords">
+          <div class="axis"><span class="axis-lbl">X</span><span class="axis-val" id="pos-x">---.--</span></div>
+          <div class="axis"><span class="axis-lbl">Y</span><span class="axis-val" id="pos-y">---.--</span></div>
+          <div class="axis"><span class="axis-lbl">Z</span><span class="axis-val" id="pos-z">---.--</span></div>
+        </div>
+        <dl class="tele-dl">
+          <div><dt>Z · OFFSET</dt><dd id="z-offset">—</dd></div>
+          <div><dt>FAN · MODEL</dt><dd id="fan-model">—</dd></div>
+          <div><dt>FAN · AUX</dt><dd id="fan-aux">—</dd></div>
+          <div><dt>FAN · CHAMBER</dt><dd id="fan-box">—</dd></div>
+          <div><dt>MAINBOARD</dt><dd class="mono-xs" id="mainboard">—</dd></div>
+        </dl>
+      </div>
+    </aside>
+  </main>
+
+  <!-- Lower rail -->
+  <footer class="rail rail-bottom">
+    <div class="rail-group">
+      <span class="rail-dim">HOST</span>
+      <span id="host">—</span>
+    </div>
+    <div class="rail-group">
+      <a href="/docs">API · OPENAPI</a>
+      <span class="rail-sep">/</span>
+      <a href="/redoc">REDOC</a>
+      <span class="rail-sep">/</span>
+      <a href="https://github.com/bjan/pycentauri" target="_blank" rel="noopener">SRC</a>
+    </div>
+  </footer>
+
+  <script src="app.js"></script>
+</body>
+</html>