# yb

> Streamlining media publishing: prepare, upload, and edit videos (YouTube) and podcasts


## Pages

- [yb](index.html.md): Streamline media publishing: **prepare a piece of media once, publish it
- [API reference](api.html.md): | `yb`   | yb — streamline media publishing: prepare once, publish to YouTube or podcast.   |
- [yb](_autosummary/yb.html.md): yb — streamline media publishing: prepare once, publish to YouTube or podcast.
- [yb.audio_convert](_autosummary/yb.audio_convert.html.md): Convert audio files between formats with ffmpeg.
- [yb.config](_autosummary/yb.config.html.md): User configuration for `yb` publishing defaults.
- [yb.content](_autosummary/yb.content.html.md): Target-agnostic publication content: prepare it once, publish anywhere.
- [yb.download](_autosummary/yb.download.html.md): Media download (yt-dlp) — fetch videos, audio, and their metadata.
- [yb.download.ranges](_autosummary/yb.download.ranges.html.md): Download just a time range of a video: parse start/end, build yt-dlp’s options.
- [yb.download.requirements](_autosummary/yb.download.requirements.html.md): Preflight for downloading: does yt-dlp have what YouTube now demands?
- [yb.download.youtube](_autosummary/yb.download.youtube.html.md): Download YouTube videos (and their metadata) via yt-dlp.
- [yb.podcast](_autosummary/yb.podcast.html.md): Podcast publishing: show notes, chapters, cover video, and RSS.
- [yb.podcast.chapters](_autosummary/yb.podcast.chapters.html.md): Podcast chapter markers: Podlove Simple Chapters (PSC) + MP3 ID3 chapters.
- [yb.podcast.cover](_autosummary/yb.podcast.cover.html.md): Cover-over-audio video: turn a podcast audio file into a simple video.
- [yb.podcast.feed](_autosummary/yb.podcast.feed.html.md): Podcast RSS feed generation (iTunes-compatible) via feedgen.
- [yb.podcast.publish](_autosummary/yb.podcast.publish.html.md): Assemble a publishable podcast episode from a media file.
- [yb.podcast.shownotes](_autosummary/yb.podcast.shownotes.html.md): Podcast show notes — the human-readable episode description block.
- [yb.youtube](_autosummary/yb.youtube.html.md): YouTube publishing via the YouTube Data API v3.
- [yb.youtube.api](_autosummary/yb.youtube.api.html.md): YouTube video operations: get, upload, update metadata, thumbnail, chapters.
- [yb.youtube.auth](_autosummary/yb.youtube.auth.html.md): OAuth 2.0 plumbing for the YouTube Data API v3.
- [yb.youtube.captions](_autosummary/yb.youtube.captions.html.md): Caption (subtitle) tracks on YouTube videos: list, insert, update, upsert.
- [yb.youtube.metadata](_autosummary/yb.youtube.metadata.html.md): YouTube video metadata ↔ API snippet mapping.
- [yb.youtube.paste_consent](_autosummary/yb.youtube.paste_consent.html.md): Paste-back OAuth consent: consent from a machine nobody is sitting at.
- [yb.youtube.playlists](_autosummary/yb.youtube.playlists.html.md): YouTube playlist operations: find/create a playlist and add videos to it.
- [yb.youtube.publish](_autosummary/yb.youtube.publish.html.md): High-level YouTube publishing: prepare → upload → captions → thumbnail.
- [yb.youtube.search](_autosummary/yb.youtube.search.html.md): Search YouTube for videos, with engagement numbers to rank them by.
- [yb.youtube.stats](_autosummary/yb.youtube.stats.html.md): Read live video metadata & engagement numbers from the YouTube Data API v3.
- [For AI agents](ai-agents.html.md): `yb` ships artifacts for coding agents alongside its code. This page lists
- [About this build](about-this-build.html.md): This documentation was built on **2026-10-14 12:40 UTC** from commit <a href="https://github.com/ree...

## Optional

- [yb.md](yb.md): Complete documentation in a single file.

## Build

- [build_info.json](build_info.json): build provenance (commit, version, tool versions, whether the docs match the package)