rendervd 0.1.0__tar.gz

rendervd-0.1.0/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project follows PEP 440 versions.
+
+## Unreleased
+
+## 0.1.0rc2 - 2026-02-13
+
+- TestPyPI validation release.
+
+- (placeholder)
+
+## 0.1.0rc1 - 2026-02-13
+
+- TestPyPI validation release (Trusted Publishing/OIDC).
+
+## 0.1.0 - 2026-02-09
+
+Initial public release.
+
+- Core CLI: `plan`, `run`, `replay`.
+- Diagnostics: `rendervd doctor` validates external tools and prints actionable output (JSON supported).
+- Subtitles/Subfix: optional OCR/mux features are enabled automatically when supported tools are present; otherwise the pipeline stays deterministic and skips those phases.
+- Packaging: PyPI-ready metadata, standard OSS repo files, and maintainer docs.

rendervd-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rendervd contributors
+
+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.

rendervd-0.1.0/MANIFEST.in

@@ -0,0 +1,16 @@
+include README.md LICENSE CHANGELOG.md pyproject.toml
+recursive-include rendervd *.py
+
+# Keep sdists clean: exclude maintainer-only material
+prune docs
+prune .github
+prune tests
+prune tools
+
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude .pytest_cache
+global-exclude *.trace.jsonl
+global-exclude .DS_Store
+
+

rendervd-0.1.0/PKG-INFO

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: rendervd
+Version: 0.1.0
+Summary: DVD/ISO → MP4 pipeline
+Author: rendervd contributors
+License-Expression: MIT
+Project-URL: Repository, https://github.com/actx4gh/rendervd
+Project-URL: Issues, https://github.com/actx4gh/rendervd/issues
+Project-URL: Changelog, https://github.com/actx4gh/rendervd/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/actx4gh/rendervd/blob/main/README.md
+Keywords: dvd,iso,ffmpeg,video,mp4,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: nox; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# rendervd
+
+`rendervd` is a command-line tool that turns a DVD source (optical disc, ISO, or a DVD-Video backup directory) into an MP4.
+
+This repository provides a **Python implementation** of `rendervd`, designed to be easy to install, test, and maintain.
+
+`rendervd` orchestrates external tools (it does **not** reimplement codecs/demuxers):
+- `ffmpeg` and `ffprobe` for ingest/probing/encoding
+- `makemkvcon` (MakeMKV) for title scanning (auto-pick) and single-title ingest
+- `dvdbackup` for mirroring optical discs to disk (optional, drive-only)
+- `subocr` + `tesseract` and `mkvextract` (MKVToolNix) for OCR’ing bitmap DVD subtitles (optional; enabled by default when the toolchain is present)
+
+## What it does
+
+- **One-shot mode:** `rendervd [options]` (plans + runs; produces the final MP4)
+- **Two-phase mode:**
+  - `rendervd plan ...` (extracts + probes + analyzes, then emits a `plan.json`)
+  - `rendervd run plan.json` (executes the plan)
+- **Replay:** `rendervd replay plan.json` replays the embedded external command graph best-effort
+  (requires the plan to be created with `--plan-include-commands`).
+
+## Requirements
+
+- Python **3.10+**
+- External tools available on `PATH`:
+  - **Required:** `ffmpeg`, `ffprobe`, `makemkvcon`
+  - **Optional (drive backup mode):** `dvdbackup` (used when `--dvd-src` is a block device like `/dev/sr0` and backup mode is `auto` or `--backup`)
+  - **Optional (Subfix / OCR toolchain):** `subocr`, `tesseract` (+ tessdata), and `mkvextract` (from MKVToolNix)
+
+### Doctor: validate your environment
+
+Run:
+
+```sh
+rendervd doctor
+```
+
+This prints a categorized report of required/recommended/optional dependencies and key FFmpeg capabilities.
+
+Exit codes:
+- `0`: all required checks pass
+- `1`: missing required tools or required FFmpeg capabilities
+- `2`: required checks pass, but some recommended/optional components are missing
+
+Machine-readable JSON:
+
+```sh
+rendervd doctor --json
+```
+
+### FFmpeg build requirements
+
+`rendervd` depends on FFmpeg features that are sometimes missing from minimal builds.
+
+**Must-have**
+
+- **H.264 encoder:** `libx264` (used for MP4 video encoding).
+  - Quick check:
+    ```sh
+    ffmpeg -hide_banner -encoders | grep -E '(^|\s)libx264(\s|$)'
+    ```
+  - If you build FFmpeg yourself, this typically means configuring with:
+    - `--enable-gpl --enable-libx264`
+
+**Needed for multi-title stitch from DVD/ISO**
+
+- **`dvdvideo` demuxer support** (used for the dvdvideo ingest path when stitching multiple titles).
+  - Quick check:
+    ```sh
+    ffmpeg -hide_banner -demuxers | grep -E '(^|\s)dvdvideo(\s|$)'
+    ```
+  - Builds without `dvdvideo` often lack the underlying DVD navigation/read libraries.
+    If building from source, ensure the FFmpeg build can find/enable common DVD libs such as
+    **libdvdnav** and **libdvdread**.
+
+**Used for analysis (usually present in normal builds)**
+
+- Filters: `idet` and `cropdetect`
+  - Quick check:
+    ```sh
+    ffmpeg -hide_banner -filters | grep -E '(^|\s)(idet|cropdetect)(\s|$)'
+    ```
+
+Notes:
+- Encrypted discs are frequently unreadable via plain FFmpeg. For those, install/use **MakeMKV** (`makemkvcon`).
+- If your FFmpeg lacks any of the above, install a “full” distro/Homebrew build or rebuild FFmpeg with the relevant options.
+
+Also:
+- Accessing an optical drive like `/dev/sr0` often requires elevated permissions (e.g. running under `sudo` or adding your user to the appropriate group).
+- Encrypted discs commonly require MakeMKV on the host system.
+
+## Install
+
+### Option A: pipx (recommended for an "installed CLI" workflow)
+
+Once published to PyPI:
+
+```sh
+pipx install rendervd
+
+# confirm
+rendervd --help
+```
+
+### Option B: venv + pip
+
+```sh
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip
+python -m pip install rendervd
+
+# confirm
+rendervd --help
+```
+
+### Option C: from source (development)
+
+```sh
+git clone <repository-url>
+cd <repository-dir>
+python -m pip install -U pip
+python -m pip install -e .
+
+# confirm
+rendervd --help
+```
+
+## Quick start
+
+### 1) One-shot: auto-pick the main title and produce an MP4
+
+```sh
+# optical drive
+PYTHONUNBUFFERED=1 rendervd --dvd-src /dev/sr0 -o ./out
+
+# ISO file
+PYTHONUNBUFFERED=1 rendervd --dvd-src ./movie.iso -o ./out
+```
+> Note: When `--dvd-src` is a block device (e.g. `/dev/sr0`), the default backup mode is **auto**: `rendervd` will mirror the disc to `<workdir>/dvd_backup` using `dvdbackup` and then ingest from the backup directory. Use `--no-backup` to read the drive directly, or `--backup --backup-dir <dir>` to force/control the backup location.
+
+If `ffmpeg`/`ffprobe` are not on your `PATH`, pass `--ffmpeg /path/to/ffmpeg --ffprobe /path/to/ffprobe`.
+
+
+### 2) Multi-title stitch (e.g., episodic discs)
+
+```sh
+PYTHONUNBUFFERED=1 rendervd --dvd-src /dev/sr0 -n 3 --min-duration 450 -o ./out
+```
+
+### 3) Plan first, then run
+
+Planning performs extraction + probes + analysis **before** writing the plan:
+
+```sh
+PYTHONUNBUFFERED=1 rendervd plan --dvd-src /dev/sr0 -o ./out -w ./work --plan-out ./plan.json
+PYTHONUNBUFFERED=1 rendervd run ./plan.json
+```
+
+### 4) Replay (best-effort)
+
+```sh
+PYTHONUNBUFFERED=1 rendervd plan --dvd-src ./movie.iso -o ./out --plan-include-commands --plan-out ./plan.json
+PYTHONUNBUFFERED=1 rendervd replay ./plan.json
+```
+
+## Titles and selection
+
+- `--titles "3,6,10"` selects specific DVD titles.
+- Otherwise, `rendervd` scans titles and auto-picks:
+  - `--count N` (default `1`) picks up to N longest titles, with a “clearly longer main feature” heuristic.
+  - `--min-duration SEC` (default `600`) ignores shorter titles.
+
+Run `rendervd --help` for the full option set.
+
+## Subtitles
+
+`rendervd` preserves subtitle streams when present on the source titles.
+
+### Subfix (OCR bitmap DVD subtitles → mov_text)
+
+Subfix is **auto-enabled by default** when the full toolchain is available:
+
+- `subocr`
+- `tesseract`
+- `mkvextract`
+
+If the toolchain is missing, Subfix is automatically disabled with a warning.
+In that case, bitmap DVD subtitles (`dvd_subtitle`) are preserved by copying them into the output MP4 as-is (no OCR).
+
+When a source contains **bitmap DVD subtitles** (`dvd_subtitle` / VobSub), rendervd will:
+- extract the per-stream concatenated subtitle-only MKV: `workdir/concat/<basename>.sMM.mkv`
+- extract `.idx/.sub` via `mkvextract` (track id 0)
+- OCR via `subocr vobsub-ocr` to SRT
+- apply the “VLC clear” fix (default: enabled; payload U+2060)
+- mux the result into the final MP4 as **`mov_text`**
+
+Disable Subfix (preserve bitmap behavior):
+
+```sh
+rendervd --no-subfix ...
+```
+
+Implementation details:
+- **Multi-title stitch:** subtitle streams are extracted per segment/per stream, concatenated per stream, then muxed.
+- **Single-title:** subtitle streams are carried through to final mux.
+
+MP4 subtitle codec policy:
+- **Bitmap DVD subs** (`dvd_subtitle` / `vobsub` / related):
+  - **Default:** OCR’d to text and muxed as `mov_text` (see Subfix above).
+  - If Subfix is disabled: **copied** (`-c:s copy`). Note: bitmap subs inside MP4 are not universally supported by every player.
+- **Text subtitles** (`subrip`/SRT, `ass`, `ssa`, `webvtt`): encoded as **`mov_text`** for MP4 compatibility.
+
+Verify subtitle presence in the final MP4:
+
+```sh
+ffprobe -v error -select_streams s -show_entries stream=index,codec_name:stream_tags=language,title -of json ./out/<NAME>.mp4
+```
+
+## Output, workdir, reruns
+
+- `--outdir DIR` controls where the final MP4 is written.
+- `--out-basename NAME` controls the final MP4 base name (default: derived from disc title; `UPPERCASE_WITH_UNDERSCORES`).
+  - Output path is `OUTDIR/OUT_BASENAME.mp4`.
+- `--basename NAME` controls the work prefix used for intermediates (default: derived from disc title when available).
+- `--workdir DIR` controls where intermediates go.
+  - If omitted, a temporary workdir is created under the current directory and auto-removed unless `--keep` is used.
+- Rerun behavior:
+  - `--overwrite` (default): overwrite expected outputs
+  - `--resume`: reuse existing intermediates/outputs when valid
+  - `--no-overwrite`: fail if expected outputs already exist
+
+## Tracing (NDJSON)
+
+You can capture a newline-delimited JSON trace of external commands:
+
+```sh
+TRACE_CMDS_ENABLED=1 TRACE_CMDS_FILE=./trace.ndjson TRACE_CMDS_APPEND=0 rendervd --dvd-src ./movie.iso -o ./out
+```
+
+## Docs
+
+- `docs/plan.md` explains `plan.json` structure and replay semantics.
+- `docs/plan.schema.json` is the machine-readable plan schema.
+
+## Development
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+pip install -U pip
+pip install -e ".[dev]"
+
+pytest -q
+```
+
+Optional:
+
+```sh
+# integration (real tools); skipped by default
+RENDERVD_INTEGRATION=1 pytest -q
+
+# Subfix integration requires a fixture MKV containing at least one dvd_subtitle stream.
+# Provide its path and enable integration:
+RENDERVD_INTEGRATION=1 RENDERVD_SUBFIX_FIXTURE_MKV=/path/to/title_with_vobsub.mkv pytest -q
+```
+
+## Legal
+
+Ensure you have the rights/authorization to copy and transcode any disc content you process.

rendervd-0.1.0/README.md

@@ -0,0 +1,270 @@
+# rendervd
+
+`rendervd` is a command-line tool that turns a DVD source (optical disc, ISO, or a DVD-Video backup directory) into an MP4.
+
+This repository provides a **Python implementation** of `rendervd`, designed to be easy to install, test, and maintain.
+
+`rendervd` orchestrates external tools (it does **not** reimplement codecs/demuxers):
+- `ffmpeg` and `ffprobe` for ingest/probing/encoding
+- `makemkvcon` (MakeMKV) for title scanning (auto-pick) and single-title ingest
+- `dvdbackup` for mirroring optical discs to disk (optional, drive-only)
+- `subocr` + `tesseract` and `mkvextract` (MKVToolNix) for OCR’ing bitmap DVD subtitles (optional; enabled by default when the toolchain is present)
+
+## What it does
+
+- **One-shot mode:** `rendervd [options]` (plans + runs; produces the final MP4)
+- **Two-phase mode:**
+  - `rendervd plan ...` (extracts + probes + analyzes, then emits a `plan.json`)
+  - `rendervd run plan.json` (executes the plan)
+- **Replay:** `rendervd replay plan.json` replays the embedded external command graph best-effort
+  (requires the plan to be created with `--plan-include-commands`).
+
+## Requirements
+
+- Python **3.10+**
+- External tools available on `PATH`:
+  - **Required:** `ffmpeg`, `ffprobe`, `makemkvcon`
+  - **Optional (drive backup mode):** `dvdbackup` (used when `--dvd-src` is a block device like `/dev/sr0` and backup mode is `auto` or `--backup`)
+  - **Optional (Subfix / OCR toolchain):** `subocr`, `tesseract` (+ tessdata), and `mkvextract` (from MKVToolNix)
+
+### Doctor: validate your environment
+
+Run:
+
+```sh
+rendervd doctor
+```
+
+This prints a categorized report of required/recommended/optional dependencies and key FFmpeg capabilities.
+
+Exit codes:
+- `0`: all required checks pass
+- `1`: missing required tools or required FFmpeg capabilities
+- `2`: required checks pass, but some recommended/optional components are missing
+
+Machine-readable JSON:
+
+```sh
+rendervd doctor --json
+```
+
+### FFmpeg build requirements
+
+`rendervd` depends on FFmpeg features that are sometimes missing from minimal builds.
+
+**Must-have**
+
+- **H.264 encoder:** `libx264` (used for MP4 video encoding).
+  - Quick check:
+    ```sh
+    ffmpeg -hide_banner -encoders | grep -E '(^|\s)libx264(\s|$)'
+    ```
+  - If you build FFmpeg yourself, this typically means configuring with:
+    - `--enable-gpl --enable-libx264`
+
+**Needed for multi-title stitch from DVD/ISO**
+
+- **`dvdvideo` demuxer support** (used for the dvdvideo ingest path when stitching multiple titles).
+  - Quick check:
+    ```sh
+    ffmpeg -hide_banner -demuxers | grep -E '(^|\s)dvdvideo(\s|$)'
+    ```
+  - Builds without `dvdvideo` often lack the underlying DVD navigation/read libraries.
+    If building from source, ensure the FFmpeg build can find/enable common DVD libs such as
+    **libdvdnav** and **libdvdread**.
+
+**Used for analysis (usually present in normal builds)**
+
+- Filters: `idet` and `cropdetect`
+  - Quick check:
+    ```sh
+    ffmpeg -hide_banner -filters | grep -E '(^|\s)(idet|cropdetect)(\s|$)'
+    ```
+
+Notes:
+- Encrypted discs are frequently unreadable via plain FFmpeg. For those, install/use **MakeMKV** (`makemkvcon`).
+- If your FFmpeg lacks any of the above, install a “full” distro/Homebrew build or rebuild FFmpeg with the relevant options.
+
+Also:
+- Accessing an optical drive like `/dev/sr0` often requires elevated permissions (e.g. running under `sudo` or adding your user to the appropriate group).
+- Encrypted discs commonly require MakeMKV on the host system.
+
+## Install
+
+### Option A: pipx (recommended for an "installed CLI" workflow)
+
+Once published to PyPI:
+
+```sh
+pipx install rendervd
+
+# confirm
+rendervd --help
+```
+
+### Option B: venv + pip
+
+```sh
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip
+python -m pip install rendervd
+
+# confirm
+rendervd --help
+```
+
+### Option C: from source (development)
+
+```sh
+git clone <repository-url>
+cd <repository-dir>
+python -m pip install -U pip
+python -m pip install -e .
+
+# confirm
+rendervd --help
+```
+
+## Quick start
+
+### 1) One-shot: auto-pick the main title and produce an MP4
+
+```sh
+# optical drive
+PYTHONUNBUFFERED=1 rendervd --dvd-src /dev/sr0 -o ./out
+
+# ISO file
+PYTHONUNBUFFERED=1 rendervd --dvd-src ./movie.iso -o ./out
+```
+> Note: When `--dvd-src` is a block device (e.g. `/dev/sr0`), the default backup mode is **auto**: `rendervd` will mirror the disc to `<workdir>/dvd_backup` using `dvdbackup` and then ingest from the backup directory. Use `--no-backup` to read the drive directly, or `--backup --backup-dir <dir>` to force/control the backup location.
+
+If `ffmpeg`/`ffprobe` are not on your `PATH`, pass `--ffmpeg /path/to/ffmpeg --ffprobe /path/to/ffprobe`.
+
+
+### 2) Multi-title stitch (e.g., episodic discs)
+
+```sh
+PYTHONUNBUFFERED=1 rendervd --dvd-src /dev/sr0 -n 3 --min-duration 450 -o ./out
+```
+
+### 3) Plan first, then run
+
+Planning performs extraction + probes + analysis **before** writing the plan:
+
+```sh
+PYTHONUNBUFFERED=1 rendervd plan --dvd-src /dev/sr0 -o ./out -w ./work --plan-out ./plan.json
+PYTHONUNBUFFERED=1 rendervd run ./plan.json
+```
+
+### 4) Replay (best-effort)
+
+```sh
+PYTHONUNBUFFERED=1 rendervd plan --dvd-src ./movie.iso -o ./out --plan-include-commands --plan-out ./plan.json
+PYTHONUNBUFFERED=1 rendervd replay ./plan.json
+```
+
+## Titles and selection
+
+- `--titles "3,6,10"` selects specific DVD titles.
+- Otherwise, `rendervd` scans titles and auto-picks:
+  - `--count N` (default `1`) picks up to N longest titles, with a “clearly longer main feature” heuristic.
+  - `--min-duration SEC` (default `600`) ignores shorter titles.
+
+Run `rendervd --help` for the full option set.
+
+## Subtitles
+
+`rendervd` preserves subtitle streams when present on the source titles.
+
+### Subfix (OCR bitmap DVD subtitles → mov_text)
+
+Subfix is **auto-enabled by default** when the full toolchain is available:
+
+- `subocr`
+- `tesseract`
+- `mkvextract`
+
+If the toolchain is missing, Subfix is automatically disabled with a warning.
+In that case, bitmap DVD subtitles (`dvd_subtitle`) are preserved by copying them into the output MP4 as-is (no OCR).
+
+When a source contains **bitmap DVD subtitles** (`dvd_subtitle` / VobSub), rendervd will:
+- extract the per-stream concatenated subtitle-only MKV: `workdir/concat/<basename>.sMM.mkv`
+- extract `.idx/.sub` via `mkvextract` (track id 0)
+- OCR via `subocr vobsub-ocr` to SRT
+- apply the “VLC clear” fix (default: enabled; payload U+2060)
+- mux the result into the final MP4 as **`mov_text`**
+
+Disable Subfix (preserve bitmap behavior):
+
+```sh
+rendervd --no-subfix ...
+```
+
+Implementation details:
+- **Multi-title stitch:** subtitle streams are extracted per segment/per stream, concatenated per stream, then muxed.
+- **Single-title:** subtitle streams are carried through to final mux.
+
+MP4 subtitle codec policy:
+- **Bitmap DVD subs** (`dvd_subtitle` / `vobsub` / related):
+  - **Default:** OCR’d to text and muxed as `mov_text` (see Subfix above).
+  - If Subfix is disabled: **copied** (`-c:s copy`). Note: bitmap subs inside MP4 are not universally supported by every player.
+- **Text subtitles** (`subrip`/SRT, `ass`, `ssa`, `webvtt`): encoded as **`mov_text`** for MP4 compatibility.
+
+Verify subtitle presence in the final MP4:
+
+```sh
+ffprobe -v error -select_streams s -show_entries stream=index,codec_name:stream_tags=language,title -of json ./out/<NAME>.mp4
+```
+
+## Output, workdir, reruns
+
+- `--outdir DIR` controls where the final MP4 is written.
+- `--out-basename NAME` controls the final MP4 base name (default: derived from disc title; `UPPERCASE_WITH_UNDERSCORES`).
+  - Output path is `OUTDIR/OUT_BASENAME.mp4`.
+- `--basename NAME` controls the work prefix used for intermediates (default: derived from disc title when available).
+- `--workdir DIR` controls where intermediates go.
+  - If omitted, a temporary workdir is created under the current directory and auto-removed unless `--keep` is used.
+- Rerun behavior:
+  - `--overwrite` (default): overwrite expected outputs
+  - `--resume`: reuse existing intermediates/outputs when valid
+  - `--no-overwrite`: fail if expected outputs already exist
+
+## Tracing (NDJSON)
+
+You can capture a newline-delimited JSON trace of external commands:
+
+```sh
+TRACE_CMDS_ENABLED=1 TRACE_CMDS_FILE=./trace.ndjson TRACE_CMDS_APPEND=0 rendervd --dvd-src ./movie.iso -o ./out
+```
+
+## Docs
+
+- `docs/plan.md` explains `plan.json` structure and replay semantics.
+- `docs/plan.schema.json` is the machine-readable plan schema.
+
+## Development
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+pip install -U pip
+pip install -e ".[dev]"
+
+pytest -q
+```
+
+Optional:
+
+```sh
+# integration (real tools); skipped by default
+RENDERVD_INTEGRATION=1 pytest -q
+
+# Subfix integration requires a fixture MKV containing at least one dvd_subtitle stream.
+# Provide its path and enable integration:
+RENDERVD_INTEGRATION=1 RENDERVD_SUBFIX_FIXTURE_MKV=/path/to/title_with_vobsub.mkv pytest -q
+```
+
+## Legal
+
+Ensure you have the rights/authorization to copy and transcode any disc content you process.