yb.podcast.cover

Cover-over-audio video: turn a podcast audio file into a simple video.

Useful for publishing an audio episode where a video is expected (YouTube): the cover image, held for the episode’s duration, muxed with the audio — optionally with a slow Ken Burns pan/zoom.

This is a thin adapter over muvid.visualize, which owns the audio→video rendering. Reach for muvid.visualize.render_audio_video() directly when you want a visual other than a held cover, a burnt-in title, or loudness normalization. Needs pip install 'yb[music]' (pulls muvid).

Functions

cover_video(audio, image, *[, saveas, ...])

Render a video of image held over audio.
yb.podcast.cover.cover_video(audio, image, *, saveas=None, ken_burns=False, size=None, fps=None, layout=None)[source]

Render a video of image held over audio.

The cover is composed onto a 16:9 canvas — filled with a blurred, darkened copy of itself rather than black bars — so square or portrait art still looks deliberate at 1080p.

Parameters:

  • audio (PathLike) – The episode audio file.

  • image (PathLike) – Cover image to display.

  • saveas (PathLike | None) – Output path (defaults to <audio-stem>.cover.mp4).

  • ken_burns (bool) – Apply a slow pan/zoom (rendered by burns) instead of a static image. Much slower than the static path.

  • size (tuple[int, int] | None) – Output resolution (width, height); defaults to 1080p.

  • fps (int | None) – Output frame rate; defaults to muvid’s default.

  • layout (CoverLayout | None) – How the cover sits on the canvas.

Return type:

Path

Returns:

Path to the rendered mp4.

Raises:

  • ImportError – the muvid package is not installed (pip install     'yb[music]').

  • FfmpegError – ffmpeg is missing, or the render failed.