discstation 0.1.11 → 0.1.12

package/README.md

@@ -47,9 +47,16 @@ playback, ripping, phone uploads, and ESP32 remote control.
 
 ```bash
 npm install -g discstation
-discstation-setup          # dispatches to the installer for your OS
+discstation-setup          # dispatches to the installer for your OS, then opens the UI
 ```
 
+The host runs as a background service; the UI is the built-in web app at
+`http://localhost:8081`. `discstation-setup` opens it when it finishes, and the
+`discstation` command re-opens it any time. It's a PWA — use your browser's
+**Install DiscStation** (or the in-page **INSTALL APP** button on Chromium) to
+get a standalone app window with a dock/taskbar icon on macOS, Linux, and
+Windows.
+
 `discstation-setup --help` lists the forwarded env vars. From a git clone,
 `npm run setup` does the same thing. Support by OS:
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "discstation",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "DiscStation optical-media appliance host — one cross-OS installer",
   "bin": {
-    "discstation-setup": "scripts/setup.mjs"
+    "discstation-setup": "scripts/setup.mjs",
+    "discstation": "scripts/open.mjs"
   },
   "scripts": {
     "setup": "node scripts/setup.mjs"

package/scripts/open.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// `discstation` — open the local web UI in the default browser.
+// The UI is a PWA: once open, use the browser's "Install DiscStation" (or the
+// in-page INSTALL APP button on Chromium) to get a standalone app window.
+
+import { spawn } from 'node:child_process';
+import { get } from 'node:http';
+
+const port = process.env.DISCSTATION_HTTP_PORT || '8081';
+const url = process.argv[2] || `http://localhost:${port}/`;
+
+function open(target) {
+  const [cmd, args] =
+    process.platform === 'darwin' ? ['open', [target]]
+    : process.platform === 'win32' ? ['cmd', ['/c', 'start', '', target]]
+    : ['xdg-open', [target]];
+  const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+  child.on('error', () => {
+    console.log(`Open this in your browser:\n  ${target}`);
+  });
+  child.unref();
+}
+
+// Best-effort liveness check so a stopped host gives a clear hint.
+const probe = get(url, { timeout: 1500 }, (res) => {
+  res.resume();
+  open(url);
+});
+probe.on('timeout', () => probe.destroy());
+probe.on('error', () => {
+  console.log(
+    `DiscStation host isn't answering on ${url}\n` +
+    `Start it with "discstation-setup" (first run) or check the service:\n` +
+    `  linux:  systemctl --user status discstation.service\n` +
+    `  macOS:  launchctl print gui/$(id -u)/com.discstation.agent`,
+  );
+  open(url);
+});

package/scripts/setup.mjs

@@ -28,6 +28,9 @@ Linux script uses sudo for apt + group membership.
 Env vars (forwarded): DISCSTATION_APP_DIR, DISCSTATION_VENV_DIR,
 DISCSTATION_CONFIG_DIR, DISCSTATION_HTTP_PORT, DISC_DEVICE, DISC_PORT.
 
+On success it opens the web UI (a PWA — install it from the browser for an app
+window). Re-open it any time with the "discstation" command.
+
 Any extra arguments are passed straight to the platform script.
 `
   );
@@ -40,6 +43,15 @@ function run(cmd, cmdArgs) {
     console.error(`\n${cmd}: ${r.error.message}`);
     process.exit(1);
   }
+  if ((r.status ?? 1) === 0) {
+    const port = process.env.DISCSTATION_HTTP_PORT || '8081';
+    console.log(
+      `\nDiscStation is installed and running.\n` +
+      `  Web UI:  http://localhost:${port}/   (run "discstation" to open it any time)\n` +
+      `  Install it as an app from the browser menu, or the in-page INSTALL APP button.\n`,
+    );
+    spawnSync(process.execPath, [join(ROOT, 'scripts', 'open.mjs')], { stdio: 'ignore' });
+  }
   process.exit(r.status ?? 1);
 }