discstation 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 phuju
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# DiscStation
+
+DiscStation is a physical-media appliance for DVD-Video, data DVDs, audio CDs,
+playback, ripping, phone uploads, and ESP32 remote control.
+
+## Hardware
+
+- **Brain:** Raspberry Pi 4/5 (or any Linux box)
+- **Remote:** ESP32-C6 with SSD1306 OLED, rotary encoder, and buttons
+- **Drive:** ATAPI DVD writer (e.g. iHAS124) over USB
+
+## Features
+
+| Mode | Description |
+|------|-------------|
+| **Burn Video DVD** | YouTube URL or local file → ffmpeg 2-pass → DVD-Video disc |
+| **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 |
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── discstation.py    # Main orchestrator, serial, web server
+│   └── discstation_burn.py       # Burn pipeline (download, convert, author, burn)
+├── 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
+└── README.md
+```
+
+## Setup
+
+### Install (any OS)
+
+```bash
+npm install -g discstation
+discstation-setup          # dispatches to the installer for your OS
+```
+
+`discstation-setup --help` lists the forwarded env vars. From a git clone,
+`npm run setup` does the same thing. Support by 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) |
+| Windows | `install-windows.ps1` — files + venv | web / serial control only, no burn backend |
+
+### Or run the platform script directly
+
+```bash
+# Linux host
+./install.sh
+
+# Arduino
+arduino-cli lib install QRCode
+# Upload arduino/c6/DiscStation_C6.ino or arduino/v1/DiscStation.ino
+# to the matching ESP32 board
+
+# macOS host
+./install-macos.sh
+
+# Windows host (web/control workflow)
+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`.
+
+## Web Interface
+
+Built-in web server on port 8080 (HTTPS with self-signed cert):
+
+- Upload files from any device on the LAN for data DVD burning
+- Submit YouTube URLs for video DVD burning
+- Dark theme, mobile-responsive, PWA (installable on phone)
+
+## Disc Support
+
+- DVD-R, DVD+R (single and dual-layer)
+- DVD-RW, DVD+RW
+- CD-R, CD-RW (audio CD ripping)
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DISC_SPEED` | auto | Burn speed (e.g. `4x`, `8x`) |
+| `DISC_TARGET_BYTES` | 4300000000 | Target size for AUTO mode |
+| `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 |
+
+### YouTube Download Configuration
+
+The host prefers an embeddable YouTube client and small HTTP chunks to reduce
+current YouTube 403 failures. It falls back to the Android VR client if needed.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `YTDLP_PLAYER_CLIENTS` | `web_embedded,android_vr` | Comma-separated clients tried in order |
+| `YTDLP_HTTP_CHUNK_SIZE` | `1M` | HTTP chunk size for media downloads |
+| `YTDLP_FORMAT` | H.264/AAC up to 720p, then generic MP4 | yt-dlp format selector override |
+| `YTDLP_RETRIES` | `3` | HTTP download retries per client |
+| `YTDLP_FRAGMENT_RETRIES` | `3` | DASH/HLS fragment retries |
+| `YTDLP_COOKIES` | unset | Netscape-format cookies file |
+| `YTDLP_COOKIES_FROM_BROWSER` | unset | Browser source such as `firefox` or `chrome` |
+| `YTDLP_USER_AGENT` | unset | Optional browser user-agent matching the cookies |
+| `YTDLP_PO_TOKEN` | unset | Client/context PO token in yt-dlp format |
+| `YTDLP_EXTRACTOR_ARGS` | unset | Additional yt-dlp extractor arguments |
+
+Cookie files and PO tokens must stay outside the repository and service logs.
+
+## Modes (Video DVD)
+
+| Mode | Quality | Use Case |
+|------|---------|----------|
+| AUTO | Standard ~4300kbps | Default |
+| BEST | Higher ~4450MB target | Quality priority |
+| LONG | Lower ~350kbps min | Long videos (>2.5h) |
+| DATA | Original quality | Files as-is on disc |
+
+## License
+
+MIT