discstation 0.1.10 → 0.1.11

package/README.md

@@ -17,23 +17,27 @@ playback, ripping, phone uploads, and ESP32 remote control.
 | **Burn Data DVD** | Any files/folders → ISO/Joliet data disc (no quality loss) |
 | **Burn MPG** | Re-burn a previously converted movie.mpg |
 | **Play** | Playback via mpv (DVD-Video, Audio CD, VCD, SVCD) |
-| **Rip** | Audio CD → FLAC with MusicBrainz metadata |
+| **Rip** | Audio CD → FLAC (MusicBrainz); DVD-Video → VIDEO_TS mirror or HandBrake MKV (TMDb naming) |
 
 ## Project Structure
 
 ```
 .
 ├── src/
-│   ├── discstation.py    # Main orchestrator, serial, web server
-│   └── discstation_burn.py       # Burn pipeline (download, convert, author, burn)
+│   ├── discstation.py        # Main orchestrator, serial, web server
+│   ├── discstation_burn.py   # Burn pipeline (download, convert, author, burn)
+│   ├── discstation_host.py   # Per-OS device/path/backend abstraction
+│   ├── discstation_meta.py   # TMDb video metadata
+│   └── static/               # Built-in web UI (index.html, app.js, style.css)
+├── mobile/                   # Expo (React Native) companion app
 ├── arduino/
-│   ├── c6/               # ESP32-C6 firmware
-│   └── v1/               # ESP32 DevKit firmware
-├── docs/                 # Platform support notes
-├── install.sh            # Linux host installer
-├── install-macos.sh      # macOS host bootstrap
-├── install-windows.ps1   # Windows host bootstrap
-├── systemd/              # Linux auto-start unit
+│   ├── c6/                   # ESP32-C6 firmware
+│   └── v1/                   # ESP32 DevKit firmware
+├── scripts/setup.mjs         # `discstation-setup` — cross-OS installer dispatch
+├── docs/                     # Platform support notes
+├── install.sh / install-macos.sh / install-windows.ps1
+├── requirements.txt / requirements-optional.txt
+├── systemd/                  # Linux auto-start unit
 └── README.md
 ```
 
@@ -52,7 +56,7 @@ discstation-setup          # dispatches to the installer for your OS
 | OS | What runs | Optical support |
 |----|-----------|-----------------|
 | Linux | `install.sh` — apt deps, venv, systemd `--user` service, self-signed cert | full burn / rip / play |
-| macOS | `install-macos.sh` — Homebrew deps, venv, launchd agent, cert | experimental (set `DISC_DEVICE` if detection fails) |
+| macOS | `install-macos.sh` — Homebrew deps, venv, launchd agent, cert | burn / rip / play (audio-CD *burning* is best-effort; set `DISC_DEVICE` if detection fails) |
 | Windows | `install-windows.ps1` — files + venv | web / serial control only, no burn backend |
 
 ### Or run the platform script directly
@@ -75,9 +79,10 @@ PowerShell -ExecutionPolicy Bypass -File .\install-windows.ps1
 
 ## Platform Support
 
-Linux currently supports the complete optical workflow. macOS and Windows use
-the shared Python/web workflows, but their native optical burning backends are
-still being implemented. See `docs/PLATFORM_SUPPORT.md`.
+Linux and macOS both run the complete optical workflow (burn, rip, play) —
+macOS via `xorriso` / `hdiutil` / `cd-paranoia` / `dvdbackup` / HandBrake, with
+audio-CD *burning* the one best-effort area. Windows runs the shared Python/web
+workflow only; it has no burn backend yet. See `docs/PLATFORM_SUPPORT.md`.
 
 ## Web Interface
 
@@ -102,6 +107,11 @@ Built-in web server on port 8080 (HTTPS with self-signed cert):
 | `DISC_CLEANUP_DAYS` | 2 | Auto-cleanup old job directories |
 | `DISC_OUTPUT_LIMIT_BYTES` | 4300000000 | Conservative DVD5 payload limit |
 | `DISC_DL_OUTPUT_LIMIT_BYTES` | 8000000000 | Conservative DVD9 payload limit |
+| `DISC_DEVICE` | auto | Optical drive node override (required on Windows) |
+| `DISC_PORT` | auto | ESP32 serial port override |
+| `DISCSTATION_HTTP_PORT` | 8081 | Plain-HTTP port for the mobile app (`0` disables) |
+| `DISCSTATION_DVD_RIP_MODE` | mirror | `mkv` = HandBrake main-feature transcode instead of a full VIDEO_TS mirror |
+| `DISC_AUDIO_DEVICE` | auto | mpv audio-output device override |
 
 ### YouTube Download Configuration
 

package/docs/PLATFORM_SUPPORT.md

@@ -9,16 +9,23 @@ 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.
+Near-complete native support via Homebrew dependencies (`install-macos.sh`
+installs them and a persistent `launchd` agent):
+
+- **Detect** — optical device via `ioreg` / `drutil` / `diskutil`; blank and
+  rewritable media are classified, so the OLED offers the burn menu.
+- **Burn** — data and DVD-Video images are built with `xorriso -as mkisofs`
+  (`-dvd-video` for a set-top-compatible VIDEO_TS layout) and written with
+  `hdiutil burn` (progress streamed from its `-puppetstrings` output).
+- **Rip** — audio CD via `cd-paranoia` → FLAC with MusicBrainz metadata and
+  cover art; DVD-Video via `dvdbackup -M` (or HandBrake main-feature with
+  `DISCSTATION_DVD_RIP_MODE=mkv`), `libdvdcss` handling CSS.
+- **Play** — `mpv`, with `dvdnav://` menu navigation for DVD-Video and a
+  mounted-VOB fallback.
+
+Set `DISC_DEVICE` if automatic drive detection fails. The one known limitation
+is **audio-CD *burning*** — `cdrdao` is the only option and often cannot claim
+the drive on recent macOS; DiscStation reports this clearly instead of hanging.
 
 ## Windows
 
@@ -32,8 +39,8 @@ instead of silently attempting Linux commands.
 - DiscStation workflows and web UI
 - ESP32 serial protocol
 - File upload and folder preservation
-- Video/audio metadata handling
+- Video/audio metadata handling (MusicBrainz, TMDb)
 - 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.
+The optical-drive backend is the platform boundary. Linux and macOS are
+complete (bar macOS audio-CD burning); Windows still needs its writer backend.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discstation",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "DiscStation optical-media appliance host — one cross-OS installer",
   "bin": {
     "discstation-setup": "scripts/setup.mjs"

package/scripts/setup.mjs

@@ -18,7 +18,7 @@ if (args.includes('-h') || args.includes('--help')) {
 
 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)
+  darwin   install-macos.sh    full: Homebrew deps, venv, launchd agent, cert (audio-CD burn is best-effort)
   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)

package/src/discstation_host.py

@@ -289,10 +289,6 @@ def null_device():
     return "NUL" if system_name() == "windows" else "/dev/null"
 
 
-def can_use_linux_optical_backend():
-    return system_name() == "linux" and all(shutil.which(name) for name in ("growisofs", "wodim", "cdrdao"))
-
-
 def build_data_image(source_paths, output_path, label, video=False):
     system = system_name()
     if system in ("darwin", "windows"):