Skip to main content

bgng url

bgng url <URL> fetches one YouTube transcript, writes Markdown/text/metadata files, and indexes the result. bgng url batch-process processes pending queue entries serially.

Capture one URL

bgng url "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
bgng url "<URL>" --lang fr
bgng url "<URL>" --mode auto
bgng url "<URL>" --no-index
bgng url "<URL>" --force

Accepted URL forms include watch?v=, youtu.be/, shorts/, embed/, live/, and bare 11-character video ids.

Flags

FlagDescription
--lang=<code>Preferred transcript language. Defaults to config transcriptLang.
--mode=<mode>native, auto, or generate. Defaults to config transcriptMode.
--no-indexSave files without qmd indexing.
--forceRe-fetch even if the video id is already in the library.
--output-dir=<path>Write flat into the exact directory. Mutually exclusive with --into.
--into=<path>Create the date/slug folder under a parent directory.

Batch processing

bgng url batch-process
bgng url batch-process --dry-run
bgng url batch-process --no-index

The batch processor reads queue.md, rewrites the queue after every successful URL, and waits two seconds between requests.