Download YouTube videos or entire PL playlists. Progress uses GGBRO Downloads; Apps tile + playlist player buttons.
plugin.js below is only the sandboxed Settings / Apps companion (~help text + open button).
yt-dlp downloads, quality picker, playlist download, and Downloads popup are host/Electron features — plugin.js is only the companion panel.
Desktop host modules (shipped inside ggbro, not this zip):
frontend/src/renderer/components/plugins/YoutubeDownloaderHostApp.tsxfrontend/src/renderer/components/apps/YtPlaylistPanel.tsxfrontend/src/main (youtube:download / yt-dlp IPC)Sandbox packs cannot run Electron, yt-dlp, or pdf.js — that is why the real UI stays in the host. Install the pack → Apps grid to use the full feature.
{
"id": "com.ggbro.plugin.youtube-downloader",
"name": "YouTube Downloader",
"version": "1.0.1",
"author": "ggbro",
"description": "Download YouTube videos or entire PL playlists. Progress uses GGBRO Downloads; Apps tile + playlist player buttons.",
"main": "plugin.js",
"permissions": ["ui.panel", "ui.toast", "ui.sound", "storage"]
}
/**
* YouTube Downloader — companion stub.
* Real downloads run in the desktop host App (yt-dlp + Downloads popup).
*/
(async function () {
try {
ggbro.log('youtube-downloader companion ready');
} catch (e) {
ggbro.log('youtube-downloader init', e && e.message);
}
})();
# YouTube Downloader (official)
**This pack is NOT the full downloader.** `plugin.js` is only the Settings / Apps companion
(help text + tips). Real downloads use **yt-dlp inside the ggbro desktop host**.
Host modules (shipped in the desktop app):
- `YoutubeDownloaderHostApp.tsx`
- `YtPlaylistPanel.tsx` (per-track / Download all)
- main-process `youtube:download` IPC
## How to know if it's a playlist?
1. Open the playlist (or a video playing from one) on YouTube.
2. Check the address bar for `list=`.
3. If you see **`list=PL…`** — that's a real playlist. Paste the URL into the App.
4. If you see **`list=RD…`** — that's an auto Mix, not supported for bulk download.
## Where to use it
- **Apps → YouTube Downloader** — paste a link, pick Video (MP4) or Audio (MP3), download.
- **YouTube Playlist player** — download icon on each track, or **Download all** for PL lists.
- Progress appears in the shared **Downloads** popup (multi-file queue).
Files save under your system Downloads folder in `GGBRO YouTube`.
Desktop app required (uses yt-dlp).