← All docs

YouTube & YouTube Downloader

The YouTube widget plays a video, short or playlist ad-free by extracting the stream with a managed yt-dlp binary. There are no ads by construction: the widget plays the raw video and audio streams, so there is nothing in the pipeline that injects one.

Video is never cropped — the frame letterboxes to the source ratio, so 16:9 videos and 9:16 shorts both display correctly.

What you’ll need

  • A single video or shorts URL, a playlist URL, or a custom list of video URLs
  • Nothing else up front: yt-dlp downloads on first use

Pick the source and paste URLs in ⚙; build a custom list in ▤.

Quality

Choose a cap of auto, 1080, 720, 480 or 360. Higher tiers pair a video-only DASH stream with a separate audio stream played in sync; auto picks up to 1080p.

Keeping extraction working

YouTube changes its site often enough that extraction can lag behind. When playback stops working, use the one-click Update in the widget’s ⚙ panel to fetch the latest yt-dlp release — that is almost always the fix, and it’s the reason the binary is managed rather than bundled and frozen.

YouTube Downloader

The separate YouTube Downloader widget queues video or audio-only downloads to a folder of your choice, with live progress, resume and cancel. It shares the same managed yt-dlp binary, so a single Update in either widget fixes both.

Please respect the terms

Downloading is offered for content you have the right to keep — your own uploads, Creative Commons material, or anything the rights holder permits. Whether a given download is allowed is between you and YouTube’s terms of service; the widget doesn’t make that judgement for you.

Full step-by-step guide lands with the public beta.