Repository navigation
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.
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.
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.
- 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-playlistlists 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.
- One yt-dlp process (
-
Pause, Resume, Cancel and Retry: yt-dlp notes each finished video in a
--download-archivefile 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.
- Made after the last video, then the folder is removed.
- Needs a zip library (the
zipcrate). 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.
- 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
zipcrate writes it, but very old unzip tools can't read it.
Phase 1: links you paste
Phase 2: tools for your files
Phase 3: new engines
Phase 4: beyond the desktop