Skip to content

Playlists

Khryz-Navarro edited this page Nov 12, 2026 · 2 revisions

Status: In progress · Phase 1 of the Roadmap · Issue #26

  • Part 1, into a folder: pull request #40, to be released as v0.1.19.
  • Part 2, as a zip: not started.

What it does

Paste a playlist link and download every video in it, in the quality you pick, into a folder named after the playlist. Part 2 adds the choice to save it as one .zip instead. Until part 1 is released, a link with &list= downloads only the one video.

Decided (2026-11-10)

These were this page's open questions:

  • Folder first, zip second. Part 1 saves into a folder. Part 2 adds a Folder / Zip choice.
  • Every video. Whole playlist means all of them. Picking videos (--playlist-items) can come later.
  • One at a time, in one yt-dlp process. That's kindest to YouTube's rate limits.
  • One row per playlist in the Downloads History ("12 of 40"), with a list of skipped videos when it's done. The row doesn't expand to show every video for now.

How part 1 works

  • The choice: when a link has a playlist, a switch under the preview offers This video (chosen at first) or Whole playlist · N videos. A fixed yes or no from the page decides which is used, never anything typed. A link to the playlist alone only offers the playlist.
  • Looking up the playlist: one yt-dlp call with --flat-playlist lists the titles quickly, without opening each video.
  • Downloading:
    • One yt-dlp process (--yes-playlist) goes through the videos in order.
    • They go into a folder named after the playlist, inside the save folder.
    • Each file leads with its place, so the files keep the playlist's order: 03 Video Title (1080p).mp4. The File names setting still applies.
    • The Downloads History shows one row with "12 of 40" progress.
  • Pause, Resume, Cancel and Retry: yt-dlp notes each finished video in a --download-archive file in the app's data folder, so Resume and Retry go on from where it stopped.
  • Errors: a private or removed video is skipped, and listed with yt-dlp's reason when the playlist is done. One bad video doesn't stop the rest.
  • Audio only: every video's sound is downloaded first, then converted one by one.
  • Delete: a finished playlist's videos go to the Recycle Bin (the Trash on Linux), and its folder is removed if that left it empty. A canceled playlist keeps the videos it finished.

Part 2: the zip

  • Made after the last video, then the folder is removed.
  • Needs a zip library (the zip crate). Videos are already compressed, so the zip stores them without compressing again (Stored), which is fast.
  • The originals are removed only once the zip is complete, so a full disk can't lose them.
  • Cancel has to stop work that runs inside the app, not only yt-dlp and ffmpeg.

Risks

  • Big playlists: downloads can run for hours and need lots of disk space. Part 1 shows how many videos there are, not the total size: a quick lookup doesn't know it. Part 2 needs room for the zip next to the videos while it's being made.
  • Rate limits: YouTube may slow down or block many downloads in a row. Signed-in cookies help, with the same account cautions as in the README.
  • Zip size: above 4 GB a zip needs the Zip64 format. The zip crate writes it, but very old unzip tools can't read it.

Home

Roadmap

Phase 1: links you paste

Phase 2: tools for your files

Phase 3: new engines

Phase 4: beyond the desktop

Clone this wiki locally