HDR DynMeta Docs
Context: $ARGUMENTS
Quick start
- Find a dovi_tool / hdr10plus_tool subcommand or flag: → Step 2 (
search)
- Read the full README section: → Step 3 (
section)
- Grab a whole README / release-notes page: → Step 4 (
fetch)
- Prime cache for offline use: → Step 5 (
index)
When to use
- User asks "which Dolby Vision profiles does dovi_tool support?" (answer: 4, 5, 7, 8.1, 8.4 — 8.2 unknown).
- User asks about hdr10plus_tool subcommands (extract / inject / remove / plot / editor).
- User is about to chain
ffmpeg bsf=hevc_mp4toannexb | dovi_tool extract-rpu | … and needs to verify flag names.
- Need latest release version and Rust MSRV before recommending install method.
- For the execution side (actually running these tools), see
hdr-dovi-tool + hdr-hdr10plus-tool skills.
Step 1 — Page catalog
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py list-pages
| Page |
URL |
dovi-readme |
github.com/quietvoid/dovi_tool/blob/main/README.md (raw) |
dovi-releases |
api.github.com/repos/quietvoid/dovi_tool/releases/latest |
hdr10plus-readme |
github.com/quietvoid/hdr10plus_tool/blob/main/README.md (raw) |
hdr10plus-releases |
api.github.com/repos/quietvoid/hdr10plus_tool/releases/latest |
Read references/subcommands.md for the verified subcommand + flag catalog.
Step 2 — Search first
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "extract-rpu" --page dovi-readme
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "editor" --page hdr10plus-readme
Use --format json for machine-parseable output.
Step 3 — Read a section
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py section --page dovi-readme --id Usage
Step 4 — Fetch a page
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py fetch --page dovi-readme
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py fetch --page hdr10plus-releases
Step 5 — Prime the cache
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py index
Cache dir: ~/.cache/hdr-dynmeta-docs/. Override with HDR_DYNMETA_DOCS_CACHE=/path.
Gotchas
- Both tools are by
quietvoid, written in Rust. Install via cargo install (from source) or pre-built binaries from each repo's Releases. hdr10plus_tool 1.7.2 (Dec 2025) requires Rust ≥ 1.85.0. dovi_tool tracks similar recent MSRVs.
- dovi_tool supported DV profiles: 4, 5, 7, 8.1, 8.4. Profile 8.2 is NOT documented as supported — if a user asks, do not assume it works. Profile 7 is BL+EL (dual-layer) and can be
convert-ed to 8.1 (single-layer with RPU).
- Canonical dovi_tool subcommands (verified):
info, generate, editor, export, plot, convert, demux, mux, extract-rpu, inject-rpu, remove.
- Canonical hdr10plus_tool subcommands (verified):
extract, inject, remove, plot, editor. No convert / demux / mux — those are dovi_tool only.
- Input to
extract-rpu and extract must be HEVC Annex-B bytestream, NOT MP4/MKV-muxed HEVC. Extract it first: ffmpeg -i in.mkv -c:v copy -bsf:v hevc_mp4toannexb -f hevc - | dovi_tool extract-rpu -.
- After
inject-rpu / inject, you get Annex-B HEVC again — you have to re-mux into MKV via mkvmerge or MP4 via MP4Box. ffmpeg's MP4 muxer for HEVC+RPU is flaky; MP4Box is recommended.
- GitHub API rate limit: unauthenticated requests are capped at 60/hour. The release-info pages use
api.github.com. Set GITHUB_TOKEN=… env var for 5000/hour if you hit the limit.
- Release-note pages are JSON from the GitHub API — text-extracted to show tag name, published date, and body.
- Docs are Markdown from
raw.githubusercontent.com — preserved as-is by the script (no HTML→text conversion). Headings with ## map cleanly to section --id Heading.
- Neither tool writes HDR10+ or Dolby Vision from scratch. They operate on existing RPU/SEI data. "Generate" in dovi_tool produces profile-compliant RPU from input like L1 analysis + Dolby XML — it's authoring, not AI. No tool "adds Dolby Vision to an SDR video" on its own.
- The script is stdlib-only. No cargo, no Rust needed to read docs — only to run the actual tools.
Examples
Example 1 — "What Dolby Vision profiles does dovi_tool support?"
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "profile" --page dovi-readme --limit 10
Example 2 — "How does dovi_tool editor work?"
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "editor" --page dovi-readme
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py section --page dovi-readme --id editor
Example 3 — "What's the latest hdr10plus_tool version?"
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py fetch --page hdr10plus-releases
Example 4 — "How do I extract RPU from a Blu-ray remux?"
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "extract-rpu" --page dovi-readme
Example 5 — "Does hdr10plus_tool have a convert command?"
uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "convert" --page hdr10plus-readme
# (expected: no hits — hdr10plus_tool has extract/inject/remove/plot/editor only)
Troubleshooting
Error: urlopen error 403 from GitHub API
Cause: Rate-limited (60 unauth requests/hour).
Solution: Set GITHUB_TOKEN=... env var (a public-repo-read token is enough).
Search returns no hits for a subcommand you think exists
Cause: Wrong tool or wrong page. convert is dovi_tool only; editor is in both; x265-encode isn't a real subcommand (that's a convenience preset in hdr-hdr10plus-tool wrapper).
Solution: Drop --page to search both READMEs. Consult references/subcommands.md.
Cache is stale after upstream release
Solution: clear-cache then index.
Reference docs
- Full subcommand + flag catalog (verified against current READMEs) →
references/subcommands.md.
1---2name: hdr-dynmeta-docs3description: Search and fetch docs for HDR dynamic-metadata CLIs: dovi_tool (Dolby Vision RPU authoring — profiles 4, 5, 7, 8.1, 8.4 — github.com/quietvoid/dovi_tool) and hdr10plus_tool (HDR10+ SEI authoring — github.com/quietvoid/hdr10plus_tool). Canonical subcommand lists (info, generate, editor, export, plot, convert, demux, mux, extract-rpu, inject-rpu for dovi_tool; extract, inject, remove, plot, editor for hdr10plus_tool), HEVC Annex-B + Matroska I/O, integration with ffmpeg bitstream filters + mkvmerge + MP4Box. Use when the user asks to look up a dovi_tool or hdr10plus_tool subcommand, check Dolby Vision profile support, verify HDR dynamic-metadata tool usage, or read the canonical GitHub README.4---56# HDR DynMeta Docs78**Context:** $ARGUMENTS910## Quick start1112- **Find a dovi_tool / hdr10plus_tool subcommand or flag:** → Step 2 (`search`)13- **Read the full README section:** → Step 3 (`section`)14- **Grab a whole README / release-notes page:** → Step 4 (`fetch`)15- **Prime cache for offline use:** → Step 5 (`index`)1617## When to use1819- User asks "which Dolby Vision profiles does dovi_tool support?" (answer: 4, 5, 7, 8.1, 8.4 — 8.2 unknown).20- User asks about hdr10plus_tool subcommands (extract / inject / remove / plot / editor).21- User is about to chain `ffmpeg bsf=hevc_mp4toannexb | dovi_tool extract-rpu | …` and needs to verify flag names.22- Need latest release version and Rust MSRV before recommending install method.23- For the execution side (actually running these tools), see `hdr-dovi-tool` + `hdr-hdr10plus-tool` skills.2425---2627## Step 1 — Page catalog2829```bash30uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py list-pages31```3233| Page | URL |34|---|---|35| `dovi-readme` | `github.com/quietvoid/dovi_tool/blob/main/README.md` (raw) |36| `dovi-releases` | `api.github.com/repos/quietvoid/dovi_tool/releases/latest` |37| `hdr10plus-readme` | `github.com/quietvoid/hdr10plus_tool/blob/main/README.md` (raw) |38| `hdr10plus-releases` | `api.github.com/repos/quietvoid/hdr10plus_tool/releases/latest` |3940Read [`references/subcommands.md`](references/subcommands.md) for the verified subcommand + flag catalog.4142---4344## Step 2 — Search first4546```bash47uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "extract-rpu" --page dovi-readme48```4950```bash51uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "editor" --page hdr10plus-readme52```5354Use `--format json` for machine-parseable output.5556---5758## Step 3 — Read a section5960```bash61uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py section --page dovi-readme --id Usage62```6364---6566## Step 4 — Fetch a page6768```bash69uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py fetch --page dovi-readme70uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py fetch --page hdr10plus-releases71```7273---7475## Step 5 — Prime the cache7677```bash78uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py index79```8081Cache dir: `~/.cache/hdr-dynmeta-docs/`. Override with `HDR_DYNMETA_DOCS_CACHE=/path`.8283---8485## Gotchas8687- **Both tools are by `quietvoid`, written in Rust.** Install via `cargo install` (from source) or pre-built binaries from each repo's Releases. hdr10plus_tool 1.7.2 (Dec 2025) requires Rust ≥ 1.85.0. dovi_tool tracks similar recent MSRVs.88- **dovi_tool supported DV profiles: 4, 5, 7, 8.1, 8.4.** Profile 8.2 is NOT documented as supported — if a user asks, do not assume it works. Profile 7 is BL+EL (dual-layer) and can be `convert`-ed to 8.1 (single-layer with RPU).89- **Canonical dovi_tool subcommands (verified):** `info`, `generate`, `editor`, `export`, `plot`, `convert`, `demux`, `mux`, `extract-rpu`, `inject-rpu`, `remove`.90- **Canonical hdr10plus_tool subcommands (verified):** `extract`, `inject`, `remove`, `plot`, `editor`. No `convert` / `demux` / `mux` — those are dovi_tool only.91- **Input to `extract-rpu` and `extract` must be HEVC Annex-B bytestream**, NOT MP4/MKV-muxed HEVC. Extract it first: `ffmpeg -i in.mkv -c:v copy -bsf:v hevc_mp4toannexb -f hevc - | dovi_tool extract-rpu -`.92- **After `inject-rpu` / `inject`, you get Annex-B HEVC again** — you have to re-mux into MKV via `mkvmerge` or MP4 via `MP4Box`. ffmpeg's MP4 muxer for HEVC+RPU is flaky; MP4Box is recommended.93- **GitHub API rate limit:** unauthenticated requests are capped at 60/hour. The release-info pages use `api.github.com`. Set `GITHUB_TOKEN=…` env var for 5000/hour if you hit the limit.94- **Release-note pages are JSON from the GitHub API** — text-extracted to show tag name, published date, and body.95- **Docs are Markdown from `raw.githubusercontent.com`** — preserved as-is by the script (no HTML→text conversion). Headings with `##` map cleanly to `section --id Heading`.96- **Neither tool writes HDR10+ or Dolby Vision from scratch.** They operate on existing RPU/SEI data. "Generate" in dovi_tool produces profile-compliant RPU from input like L1 analysis + Dolby XML — it's authoring, not AI. No tool "adds Dolby Vision to an SDR video" on its own.97- **The script is stdlib-only.** No cargo, no Rust needed to read docs — only to run the actual tools.9899---100101## Examples102103### Example 1 — "What Dolby Vision profiles does dovi_tool support?"104105```bash106uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "profile" --page dovi-readme --limit 10107```108109### Example 2 — "How does `dovi_tool editor` work?"110111```bash112uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "editor" --page dovi-readme113uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py section --page dovi-readme --id editor114```115116### Example 3 — "What's the latest hdr10plus_tool version?"117118```bash119uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py fetch --page hdr10plus-releases120```121122### Example 4 — "How do I extract RPU from a Blu-ray remux?"123124```bash125uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "extract-rpu" --page dovi-readme126```127128### Example 5 — "Does hdr10plus_tool have a `convert` command?"129130```bash131uv run ${CLAUDE_SKILL_DIR}/scripts/hdrdocs.py search --query "convert" --page hdr10plus-readme132# (expected: no hits — hdr10plus_tool has extract/inject/remove/plot/editor only)133```134135---136137## Troubleshooting138139### Error: `urlopen error 403` from GitHub API140141**Cause:** Rate-limited (60 unauth requests/hour).142**Solution:** Set `GITHUB_TOKEN=...` env var (a public-repo-read token is enough).143144### Search returns no hits for a subcommand you think exists145146**Cause:** Wrong tool or wrong page. `convert` is dovi_tool only; `editor` is in both; `x265-encode` isn't a real subcommand (that's a convenience preset in `hdr-hdr10plus-tool` wrapper).147**Solution:** Drop `--page` to search both READMEs. Consult `references/subcommands.md`.148149### Cache is stale after upstream release150151**Solution:** `clear-cache` then `index`.152153---154155## Reference docs156157- Full subcommand + flag catalog (verified against current READMEs) → `references/subcommands.md`.
damionrashford