video-cook 0.1.0__tar.gz

video_cook-0.1.0/LICENSE

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

video_cook-0.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: video-cook
+Version: 0.1.0
+Summary: Deterministic executor for the video-cooking skill pipeline. Handles yt-dlp download, whisperX transcription, ffmpeg burn, and mechanical shipment verification — so agents don't hand-assemble long commands.
+Author: ChHsiching
+License: MIT
+Project-URL: Homepage, https://github.com/ChHsiching/video-cook
+Project-URL: Repository, https://github.com/ChHsiching/video-cook
+Keywords: yt-dlp,whisperx,ffmpeg,subtitles,video,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: download
+Requires-Dist: yt-dlp>=2026.3.3; extra == "download"
+Provides-Extra: transcribe
+Requires-Dist: whisperx>=3.8.0; extra == "transcribe"
+Provides-Extra: all
+Requires-Dist: yt-dlp>=2026.3.3; extra == "all"
+Requires-Dist: whisperx>=3.8.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+
+# video-cook
+
+Deterministic executor for the [video-cooking](https://github.com/ChHsiching/video-cooking-skill) skill pipeline. Wraps yt-dlp, whisperX, and ffmpeg into subcommands that assemble correctly every time — so the skill docs can stay short and the agent never hand-assembles a long command.
+
+**This is the hands, not the brain.** Skills decide *what* to do, *when*, and handle creative work (translation, copywriting). cook only executes the deterministic parts and verifies the expected outputs exist.
+
+## Why
+
+The video-cooking / video-download / video-subtitle skill trio started as natural-language docs that told the agent which yt-dlp / ffmpeg / whisperx commands to run. Three classes of bugs kept recurring:
+
+1. **Shell escaping traps** — Windows paths with `C:` break ffmpeg's `ass` filter; backslashes get eaten by PowerShell; stdout redirects silently swallow downloads.
+2. **Hand-assembly drift** — the agent forgets a flag (`--convert-thumbnails jpg`), picks the wrong template variable, renames the wrong file.
+3. **No mechanical completion check** — "the agent feels done" is not a Done criterion. Real runs shipped without `cover.jpg`, without `cloud-srt/`, with translation drift the agent couldn't see.
+
+cook fixes all three by being the single place where the commands are assembled. The skill docs shrink to a pipeline skeleton; the completion criteria become "cook exit 0".
+
+## Install
+
+**Option 1: One-liner via uv** (recommended — uv handles Python interpreter + isolated env + PATH wiring automatically, no pip/venv knowledge needed):
+
+```bash
+# Linux / macOS
+curl -LsSf https://github.com/ChHsiching/video-cook/releases/latest/download/install.sh | sh
+# Windows (PowerShell)
+irm https://github.com/ChHsiching/video-cook/releases/latest/download/install.ps1 | iex
+```
+
+The installer uses [uv](https://astral.sh/uv/) to install `video-cook[all]` as an isolated tool (~2GB — pulls whisperx + torch). After install, open a new shell and run `cook doctor`.
+
+**Option 2: pip directly**:
+
+```bash
+pip install video-cook[all]       # yt-dlp + whisperx + cook itself
+# or pick what you need:
+pip install video-cook[download]   # for `cook download`
+pip install video-cook[transcribe] # for `cook transcribe`
+```
+
+ffmpeg and Node.js must be on PATH separately (cook can't pip-install those).
+
+## Subcommands
+
+| Command | What it does | Replaces (manual steps) |
+|---|---|---|
+| `cook doctor` | Check environment (ffmpeg/node/yt-dlp/whisperx/torch+CUDA) | Skill's "Environment reuse" prose |
+| `cook download <url>` | yt-dlp download + cookie negotiation + thumbnail rename + ffprobe verify | video-download Steps 1-3 |
+| `cook extract <root> <name>` | ffmpeg 16kHz mono WAV extraction | video-subtitle Step 1 |
+| `cook transcribe <root> <name>` | whisperX transcription, auto-detects CUDA, auto-detaches | video-subtitle Step 2 |
+| `cook subtitles <root> <name>` | shorten → merge-short → biliteral → ASS + cloud-srt in one shot | video-subtitle Step 4 + cloud-srt |
+| `cook burn <root> <name>` | ffmpeg subtitle burning, auto-detaches, subprocess list-form | video-subtitle Step 5 |
+| `cook cover <root> <name>` | Place `cover.jpg` in `cooked/` (reuses raw thumbnail) | video-subtitle Step 6 cover task |
+| `cook show-source <root> <name>` | Extract key fields (title/uploader/links/description) from source.json | (new — surfaces the source context for translation + upload metadata) |
+| `cook verify-align <root> <name>` | DP-align `en.srt` vs `translations.txt`, catch missing/drifted translations | (new — no prior equivalent) |
+| `cook verify-shipment <root> <name>` | Check the full release set exists; exit 0 = ready to ship | (new — no prior equivalent) |
+
+Every command prints a JSON object on stdout (machine-readable; agents parse this) and human-readable progress on stderr. Exit codes are meaningful: 0 = done criterion passed, non-zero = it didn't.
+
+## Usage from a skill
+
+The skill docs call cook as a subprocess and branch on its exit code. Example skeleton from video-subtitle:
+
+```
+Step 1: cook extract <root> <name>           → exit 0 = done
+Step 2: cook transcribe <root> <name>        → exit 0 = launched, poll log until "[transcribe] done."
+Step 3: (agent translates → writes translations.txt)
+        cook verify-align <root> <name>      → exit 0 = aligned, proceed
+Step 4: cook subtitles <root> <name> --mode bottom-bar --bar-px 180
+Step 5: cook burn <root> <name> --mode bottom-bar --bar-px 180
+Step 6: (agent writes upload.md)
+        cook cover <root> <name>
+Step 7: (agent writes README.md)
+```
+
+The router (`video-cooking`) calls `cook verify-shipment` as the final gate before reporting the pipeline done.
+
+## Bugs that cook fixes
+
+| Bug in the old skill docs | How cook fixes it |
+|---|---|
+| `--dump-json > file.json` silently swallowed downloads | cook uses `print_to_file` (yt-dlp's native JSON-to-file option) |
+| Thumbnail came out as `<name>.raw.jpg` not `<name>.jpg` | cook renames it after download |
+| Windows `C:` paths broke ffmpeg `ass` filter | cook uses subprocess list-form (never shell), runs from subtitle/ dir with bare filename |
+| `subtitles.py split` leaked single-language cues across zh.srt/en.srt | cook copies `*.merged.srt` to cloud-srt instead of splitting bilingual.srt |
+| `transcribe.py` hardcoded `device="cpu"`, float16 unusable on GPU | cook auto-detects CUDA → float16+cuda, else float32+cpu |
+| `source.json` downloaded but never read by downstream — author/links/description wasted | `cook show-source` surfaces the curated fields translation and upload metadata consume |
+| detached template only covered transcribe, not burn | cook's `_detach()` helper handles both uniformly |
+| No mechanical way to catch translation drift | `cook verify-align` runs DP global alignment |
+| No mechanical way to catch missing release-set files | `cook verify-shipment` checks every expected file |
+
+## Development
+
+```bash
+git clone https://github.com/ChHsiching/video-cook
+cd video-cook
+pip install -e .[dev]
+pytest test_cook.py -v
+```
+
+Tests cover the subcommands whose correctness is non-obvious: `verify-align` (DP alignment edge cases), `verify-shipment` (file-presence checks), and the cloud-srt copy logic (the fix for the split leak). No network, no ffmpeg, no whisperx — all tests use temp dirs and fake files.
+
+## License
+
+MIT

video_cook-0.1.0/README.md

@@ -0,0 +1,103 @@
+# video-cook
+
+Deterministic executor for the [video-cooking](https://github.com/ChHsiching/video-cooking-skill) skill pipeline. Wraps yt-dlp, whisperX, and ffmpeg into subcommands that assemble correctly every time — so the skill docs can stay short and the agent never hand-assembles a long command.
+
+**This is the hands, not the brain.** Skills decide *what* to do, *when*, and handle creative work (translation, copywriting). cook only executes the deterministic parts and verifies the expected outputs exist.
+
+## Why
+
+The video-cooking / video-download / video-subtitle skill trio started as natural-language docs that told the agent which yt-dlp / ffmpeg / whisperx commands to run. Three classes of bugs kept recurring:
+
+1. **Shell escaping traps** — Windows paths with `C:` break ffmpeg's `ass` filter; backslashes get eaten by PowerShell; stdout redirects silently swallow downloads.
+2. **Hand-assembly drift** — the agent forgets a flag (`--convert-thumbnails jpg`), picks the wrong template variable, renames the wrong file.
+3. **No mechanical completion check** — "the agent feels done" is not a Done criterion. Real runs shipped without `cover.jpg`, without `cloud-srt/`, with translation drift the agent couldn't see.
+
+cook fixes all three by being the single place where the commands are assembled. The skill docs shrink to a pipeline skeleton; the completion criteria become "cook exit 0".
+
+## Install
+
+**Option 1: One-liner via uv** (recommended — uv handles Python interpreter + isolated env + PATH wiring automatically, no pip/venv knowledge needed):
+
+```bash
+# Linux / macOS
+curl -LsSf https://github.com/ChHsiching/video-cook/releases/latest/download/install.sh | sh
+# Windows (PowerShell)
+irm https://github.com/ChHsiching/video-cook/releases/latest/download/install.ps1 | iex
+```
+
+The installer uses [uv](https://astral.sh/uv/) to install `video-cook[all]` as an isolated tool (~2GB — pulls whisperx + torch). After install, open a new shell and run `cook doctor`.
+
+**Option 2: pip directly**:
+
+```bash
+pip install video-cook[all]       # yt-dlp + whisperx + cook itself
+# or pick what you need:
+pip install video-cook[download]   # for `cook download`
+pip install video-cook[transcribe] # for `cook transcribe`
+```
+
+ffmpeg and Node.js must be on PATH separately (cook can't pip-install those).
+
+## Subcommands
+
+| Command | What it does | Replaces (manual steps) |
+|---|---|---|
+| `cook doctor` | Check environment (ffmpeg/node/yt-dlp/whisperx/torch+CUDA) | Skill's "Environment reuse" prose |
+| `cook download <url>` | yt-dlp download + cookie negotiation + thumbnail rename + ffprobe verify | video-download Steps 1-3 |
+| `cook extract <root> <name>` | ffmpeg 16kHz mono WAV extraction | video-subtitle Step 1 |
+| `cook transcribe <root> <name>` | whisperX transcription, auto-detects CUDA, auto-detaches | video-subtitle Step 2 |
+| `cook subtitles <root> <name>` | shorten → merge-short → biliteral → ASS + cloud-srt in one shot | video-subtitle Step 4 + cloud-srt |
+| `cook burn <root> <name>` | ffmpeg subtitle burning, auto-detaches, subprocess list-form | video-subtitle Step 5 |
+| `cook cover <root> <name>` | Place `cover.jpg` in `cooked/` (reuses raw thumbnail) | video-subtitle Step 6 cover task |
+| `cook show-source <root> <name>` | Extract key fields (title/uploader/links/description) from source.json | (new — surfaces the source context for translation + upload metadata) |
+| `cook verify-align <root> <name>` | DP-align `en.srt` vs `translations.txt`, catch missing/drifted translations | (new — no prior equivalent) |
+| `cook verify-shipment <root> <name>` | Check the full release set exists; exit 0 = ready to ship | (new — no prior equivalent) |
+
+Every command prints a JSON object on stdout (machine-readable; agents parse this) and human-readable progress on stderr. Exit codes are meaningful: 0 = done criterion passed, non-zero = it didn't.
+
+## Usage from a skill
+
+The skill docs call cook as a subprocess and branch on its exit code. Example skeleton from video-subtitle:
+
+```
+Step 1: cook extract <root> <name>           → exit 0 = done
+Step 2: cook transcribe <root> <name>        → exit 0 = launched, poll log until "[transcribe] done."
+Step 3: (agent translates → writes translations.txt)
+        cook verify-align <root> <name>      → exit 0 = aligned, proceed
+Step 4: cook subtitles <root> <name> --mode bottom-bar --bar-px 180
+Step 5: cook burn <root> <name> --mode bottom-bar --bar-px 180
+Step 6: (agent writes upload.md)
+        cook cover <root> <name>
+Step 7: (agent writes README.md)
+```
+
+The router (`video-cooking`) calls `cook verify-shipment` as the final gate before reporting the pipeline done.
+
+## Bugs that cook fixes
+
+| Bug in the old skill docs | How cook fixes it |
+|---|---|
+| `--dump-json > file.json` silently swallowed downloads | cook uses `print_to_file` (yt-dlp's native JSON-to-file option) |
+| Thumbnail came out as `<name>.raw.jpg` not `<name>.jpg` | cook renames it after download |
+| Windows `C:` paths broke ffmpeg `ass` filter | cook uses subprocess list-form (never shell), runs from subtitle/ dir with bare filename |
+| `subtitles.py split` leaked single-language cues across zh.srt/en.srt | cook copies `*.merged.srt` to cloud-srt instead of splitting bilingual.srt |
+| `transcribe.py` hardcoded `device="cpu"`, float16 unusable on GPU | cook auto-detects CUDA → float16+cuda, else float32+cpu |
+| `source.json` downloaded but never read by downstream — author/links/description wasted | `cook show-source` surfaces the curated fields translation and upload metadata consume |
+| detached template only covered transcribe, not burn | cook's `_detach()` helper handles both uniformly |
+| No mechanical way to catch translation drift | `cook verify-align` runs DP global alignment |
+| No mechanical way to catch missing release-set files | `cook verify-shipment` checks every expected file |
+
+## Development
+
+```bash
+git clone https://github.com/ChHsiching/video-cook
+cd video-cook
+pip install -e .[dev]
+pytest test_cook.py -v
+```
+
+Tests cover the subcommands whose correctness is non-obvious: `verify-align` (DP alignment edge cases), `verify-shipment` (file-presence checks), and the cloud-srt copy logic (the fix for the split leak). No network, no ffmpeg, no whisperx — all tests use temp dirs and fake files.
+
+## License
+
+MIT