discstation 0.1.0

package/discstation.env.example

@@ -0,0 +1,19 @@
+# Optional YouTube access settings. Copy to ~/.local/share/discstation/discstation.env.
+# Do not commit cookies, user-agent values, or PO tokens.
+YTDLP_PLAYER_CLIENTS=web_embedded,android_vr
+YTDLP_HTTP_CHUNK_SIZE=1M
+YTDLP_RETRIES=3
+YTDLP_FRAGMENT_RETRIES=3
+DISC_OUTPUT_LIMIT_BYTES=4300000000
+DISC_DL_OUTPUT_LIMIT_BYTES=8000000000
+
+# TMDb API key for video (DVD / burned movie) metadata lookup. Get a free key at
+# https://www.themoviedb.org/settings/api . Without it, ripped videos keep their
+# disc-label / filename naming. Alternatively put the key in
+# ~/.local/share/discstation/tmdb.key
+# DISCSTATION_TMDB_API_KEY=
+# YTDLP_COOKIES_FROM_BROWSER=firefox
+# YTDLP_COOKIES=/home/phuju/.config/discstation/youtube-cookies.txt
+# YTDLP_USER_AGENT=Mozilla/5.0 ...
+# YTDLP_PO_TOKEN=web_embedded.gvs+TOKEN
+# YTDLP_EXTRACTOR_ARGS=youtube:player_client=web_embedded

package/docs/PLATFORM_SUPPORT.md

@@ -0,0 +1,39 @@
+# DiscStation Platform Support
+
+## Linux
+
+Full host support: DVD-Video, data discs, ISO images, audio CDs, ripping,
+playback, HTTPS web UI, ESP32 serial, and ESP32 Wi-Fi/OTA.
+
+Run `./install.sh` on Debian, Ubuntu, or Raspberry Pi OS.
+
+## macOS
+
+The Python host and web/control workflow run with Homebrew dependencies. Data
+and DVD image burning use `hdiutil`; DVD-Video discs can be mounted read-only
+for playback and VIDEO_TS ripping; audio CD burning uses cdrdao. Optical-device
+discovery and video/audio workflows are experimental; use `DISC_DEVICE`
+when automatic detection does not find the external drive. Apple Music owns
+audio CD playback and ripping on macOS, so DiscStation does not probe or access
+audio tracks for those operations. Audio burns include CD-TEXT from the source
+folder/file name and track metadata. Apple Music may still show generic track
+names when its online CD lookup has no match; CD-TEXT-capable players can read
+the embedded names. The macOS installer installs a persistent `launchd` service.
+
+## Windows
+
+The Python host and web/control workflow can run from PowerShell. Optical
+burning needs a Windows IMAPI backend or a separately installed compatible
+burning tool. The Windows installer deliberately reports this limitation
+instead of silently attempting Linux commands.
+
+## Shared Components
+
+- DiscStation workflows and web UI
+- ESP32 serial protocol
+- File upload and folder preservation
+- Video/audio metadata handling
+- QR-code web URL display
+
+The optical-drive backend is the platform boundary. It should be completed per
+OS before claiming full native burning support on that platform.

package/install-macos.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+APP_DIR="${DISCSTATION_APP_DIR:-$HOME/Library/Application Support/DiscStation/app}"
+VENV_DIR="${DISCSTATION_VENV_DIR:-$HOME/Library/Application Support/DiscStation/venv}"
+CONFIG_DIR="${DISCSTATION_CONFIG_DIR:-$HOME/Library/Application Support/DiscStation}"
+PLIST="$HOME/Library/LaunchAgents/com.discstation.agent.plist"
+
+if [[ "$(uname -s)" != "Darwin" ]]; then
+  printf 'Run this script on macOS.\n' >&2
+  exit 1
+fi
+if ! command -v brew >/dev/null 2>&1; then
+  printf 'Homebrew is missing. Starting the official Homebrew installer...\n'
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+fi
+
+if [[ -x /opt/homebrew/bin/brew ]]; then
+  eval "$(/opt/homebrew/bin/brew shellenv)"
+elif [[ -x /usr/local/bin/brew ]]; then
+  eval "$(/usr/local/bin/brew shellenv)"
+fi
+
+if ! command -v brew >/dev/null 2>&1; then
+  printf 'Homebrew installation did not complete.\n' >&2
+  exit 1
+fi
+
+brew install python ffmpeg cdrdao dvdauthor node yt-dlp xorriso mpv libdiscid handbrake
+mkdir -p "$APP_DIR" "$VENV_DIR" "$CONFIG_DIR"
+cp -R "$ROOT_DIR/src/." "$APP_DIR/"
+python3 -m venv "$VENV_DIR"
+"$VENV_DIR/bin/python" -m pip install --upgrade pip
+if [[ -f "$ROOT_DIR/requirements.txt" ]]; then
+  "$VENV_DIR/bin/python" -m pip install -r "$ROOT_DIR/requirements.txt"
+else
+  "$VENV_DIR/bin/python" -m pip install pyserial mutagen requests yt-dlp
+fi
+
+DISC_DEVICE="${DISC_DEVICE:-}"
+DISC_PORT="${DISC_PORT:-$(ls /dev/cu.usbserial-* /dev/cu.usbmodem-* 2>/dev/null | head -1)}"
+
+if [[ ! -f "$CONFIG_DIR/server.crt" || ! -f "$CONFIG_DIR/server.key" ]]; then
+  openssl req -x509 -newkey rsa:2048 -nodes -days 3650 \
+    -keyout "$CONFIG_DIR/server.key" \
+    -out "$CONFIG_DIR/server.crt" \
+    -subj "/CN=DiscStation"
+  chmod 600 "$CONFIG_DIR/server.key"
+fi
+
+mkdir -p "$HOME/Library/LaunchAgents" "$HOME/Library/Logs"
+cat > "$PLIST" <<PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>com.discstation.agent</string>
+  <key>ProgramArguments</key><array>
+    <string>$VENV_DIR/bin/python</string>
+    <string>$APP_DIR/discstation.py</string>
+    <string>--port</string><string>8080</string>
+  </array>
+  <key>EnvironmentVariables</key><dict>
+    <key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+    <key>DISC_DEVICE</key><string>${DISC_DEVICE:-}</string>
+    <key>DISC_PORT</key><string>${DISC_PORT:-}</string>
+  </dict>
+  <key>WorkingDirectory</key><string>$APP_DIR</string>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>$HOME/Library/Logs/DiscStation.log</string>
+  <key>StandardErrorPath</key><string>$HOME/Library/Logs/DiscStation.log</string>
+</dict></plist>
+PLIST
+launchctl bootout "gui/$(id -u)" "$PLIST" 2>/dev/null || true
+launchctl bootstrap "gui/$(id -u)" "$PLIST"
+
+printf '\nDiscStation macOS host files installed at:\n%s\n' "$APP_DIR"
+printf 'Optical-device support is experimental; set DISC_DEVICE if automatic detection fails.\n'
+printf 'Run: %q %q\n' "$VENV_DIR/bin/python" "$APP_DIR/discstation.py"

package/install-windows.ps1

@@ -0,0 +1,24 @@
+$ErrorActionPreference = "Stop"
+
+$Root = Split-Path -Parent $MyInvocation.MyCommand.Path
+$App = if ($env:DISCSTATION_APP_DIR) { $env:DISCSTATION_APP_DIR } else { Join-Path $env:LOCALAPPDATA "DiscStation\app" }
+$Venv = if ($env:DISCSTATION_VENV_DIR) { $env:DISCSTATION_VENV_DIR } else { Join-Path $env:LOCALAPPDATA "DiscStation\venv" }
+
+if (-not (Get-Command py -ErrorAction SilentlyContinue)) {
+    throw "Install Python 3 from https://www.python.org/downloads/windows/ first."
+}
+
+New-Item -ItemType Directory -Force -Path $App, $Venv | Out-Null
+Copy-Item -Recurse -Force (Join-Path $Root "src\*") $App
+py -3 -m venv $Venv
+& (Join-Path $Venv "Scripts\python.exe") -m pip install --upgrade pip
+$Req = Join-Path $Root "requirements.txt"
+if (Test-Path $Req) {
+    & (Join-Path $Venv "Scripts\python.exe") -m pip install -r $Req
+} else {
+    & (Join-Path $Venv "Scripts\python.exe") -m pip install pyserial mutagen requests yt-dlp
+}
+
+Write-Host "DiscStation host files installed at $App"
+Write-Host "The web/control workflow is available; optical burning requires a Windows IMAPI backend or compatible burning tools."
+Write-Host "Run: $Venv\Scripts\python.exe $App\discstation.py"

package/install.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+APP_DIR="${DISCSTATION_APP_DIR:-$HOME/.local/share/discstation/app}"
+VENV_DIR="${DISCSTATION_VENV_DIR:-$HOME/.local/share/discstation/venv}"
+CONFIG_DIR="${DISCSTATION_CONFIG_DIR:-$HOME/.local/share/discstation}"
+
+if [[ "$(uname -s)" != "Linux" ]]; then
+  printf 'This installer is for Linux. Use install-macos.sh or install-windows.ps1.\n' >&2
+  exit 1
+fi
+
+if command -v apt-get >/dev/null 2>&1; then
+  sudo apt-get update
+  sudo apt-get install -y \
+    cdrdao dvdauthor ffmpeg genisoimage growisofs handbrake-cli lsdvd mpv \
+    nodejs openssl python3 python3-pip python3-serial python3-mutagen \
+    python3-requests python3-pyudev python3-libdiscid python3-musicbrainzngs \
+    libdiscid0 python3-venv wodim
+else
+  printf 'Unsupported Linux package manager. Install the DiscStation dependencies manually.\n' >&2
+  exit 1
+fi
+
+mkdir -p "$APP_DIR" "$CONFIG_DIR" "$VENV_DIR"
+cp -R "$ROOT_DIR/src/." "$APP_DIR/"
+if [[ ! -f "$CONFIG_DIR/discstation.env" && -f "$ROOT_DIR/discstation.env.example" ]]; then
+  cp "$ROOT_DIR/discstation.env.example" "$CONFIG_DIR/discstation.env"
+fi
+
+python3 -m venv --system-site-packages "$VENV_DIR"
+"$VENV_DIR/bin/python" -m pip install --upgrade pip
+if [[ -f "$ROOT_DIR/requirements.txt" ]]; then
+  "$VENV_DIR/bin/python" -m pip install -r "$ROOT_DIR/requirements.txt"
+else
+  "$VENV_DIR/bin/python" -m pip install pyserial mutagen requests yt-dlp
+fi
+
+if [[ ! -f "$CONFIG_DIR/server.crt" || ! -f "$CONFIG_DIR/server.key" ]]; then
+  openssl req -x509 -newkey rsa:2048 -nodes -days 3650 \
+    -keyout "$CONFIG_DIR/server.key" \
+    -out "$CONFIG_DIR/server.crt" \
+    -subj "/CN=DiscStation"
+  chmod 600 "$CONFIG_DIR/server.key"
+fi
+
+sudo usermod -aG dialout,cdrom "$USER" || true
+mkdir -p "$HOME/.config/systemd/user"
+cp "$ROOT_DIR/systemd/discstation.service" "$HOME/.config/systemd/user/discstation.service"
+systemctl --user daemon-reload
+systemctl --user enable --now discstation.service
+
+printf '\nDiscStation installed. Log out/in if device permissions changed.\n'
+printf 'App: %s\n' "$APP_DIR"
+printf 'Web: https://%s:8080\n' "$(hostname -I | awk '{print $1}')"

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "discstation",
+  "version": "0.1.0",
+  "description": "DiscStation optical-media appliance host — one cross-OS installer",
+  "bin": {
+    "discstation-setup": "scripts/setup.mjs"
+  },
+  "scripts": {
+    "setup": "node scripts/setup.mjs"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "files": [
+    "scripts/",
+    "src/*.py",
+    "src/static/",
+    "arduino/",
+    "systemd/",
+    "docs/",
+    "install.sh",
+    "install-macos.sh",
+    "install-windows.ps1",
+    "requirements.txt",
+    "discstation.env.example",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phuju/dvd-station.git"
+  },
+  "keywords": [
+    "dvd",
+    "cd",
+    "optical",
+    "burn",
+    "rip",
+    "appliance"
+  ],
+  "license": "MIT",
+  "private": false
+}

package/requirements.txt

@@ -0,0 +1,20 @@
+# DiscStation Python dependencies.
+#
+# On Debian/Ubuntu, prefer the system packages (see install.sh):
+#   python3-serial python3-mutagen python3-requests python3-pyudev
+#   python3-libdiscid python3-musicbrainzngs
+# The pip names below are for venv / macOS / Windows installs.
+
+pyserial>=3.5
+mutagen>=1.45
+requests>=2.28
+yt-dlp>=2024.1.1
+
+# Disc detection / metadata (all optional at runtime: the code degrades to the
+# previous subprocess-based paths if an import fails).
+pyudev>=0.24 ; sys_platform == "linux"
+python-libdiscid>=2.0 ; sys_platform != "win32"
+musicbrainzngs>=0.7.1
+
+# Video metadata (TMDb). Needs DISCSTATION_TMDB_API_KEY to do anything.
+tmdbsimple>=2.9

package/scripts/setup.mjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+// One entry point for installing the DiscStation host on any OS.
+// It just dispatches to the platform installer that already exists in the repo
+// (install.sh / install-macos.sh / install-windows.ps1); extra CLI args and the
+// DISCSTATION_* / DISC_* env vars are forwarded through.
+
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const args = process.argv.slice(2);
+
+if (args.includes('-h') || args.includes('--help')) {
+  process.stdout.write(
+    `discstation-setup — install the DiscStation host
+
+Runs the installer for the current OS:
+  linux    install.sh          full: apt deps, venv, systemd --user service, self-signed cert
+  darwin   install-macos.sh    full: Homebrew deps, venv, launchd agent, cert (optical is experimental)
+  windows  install-windows.ps1 files + venv only; web/serial control, no burn backend
+
+Prereqs: Node 16+, Python 3 (python3 / py on PATH), and either bash (linux/macOS)
+or PowerShell (Windows). Homebrew is auto-installed on macOS if missing; the
+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.
+
+Any extra arguments are passed straight to the platform script.
+`
+  );
+  process.exit(0);
+}
+
+function run(cmd, cmdArgs) {
+  const r = spawnSync(cmd, cmdArgs, { stdio: 'inherit', cwd: ROOT });
+  if (r.error) {
+    console.error(`\n${cmd}: ${r.error.message}`);
+    process.exit(1);
+  }
+  process.exit(r.status ?? 1);
+}
+
+function needPython(bin) {
+  const r = spawnSync(bin, ['--version'], { stdio: 'ignore' });
+  return r.status === 0;
+}
+
+switch (process.platform) {
+  case 'linux':
+  case 'darwin': {
+    const script = process.platform === 'linux' ? 'install.sh' : 'install-macos.sh';
+    if (!needPython('python3')) {
+      console.error('Python 3 not found on PATH. Install it first, then re-run.');
+      process.exit(1);
+    }
+    run('bash', [join(ROOT, script), ...args]);
+    break;
+  }
+  case 'win32': {
+    if (!needPython('py') && !needPython('python')) {
+      console.error('Python 3 not found. Install from https://www.python.org/downloads/windows/');
+      process.exit(1);
+    }
+    const ps1 = join(ROOT, 'install-windows.ps1');
+    if (!existsSync(ps1)) {
+      console.error('install-windows.ps1 missing from the package.');
+      process.exit(1);
+    }
+    run('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', ps1, ...args]);
+    break;
+  }
+  default:
+    console.error(`Unsupported platform: ${process.platform}. Run one of the install.* scripts by hand.`);
+    process.exit(1);
+}