ggbro Plugins

YouTube Downloader

com.ggbro.plugin.youtube-downloader · v1.0.1 · ui.panel, ui.toast, ui.sound, storage

Download YouTube videos or entire PL playlists. Progress uses GGBRO Downloads; Apps tile + playlist player buttons.

This is NOT the full app source. 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):

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.

manifest.json

Raw
{
  "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"]
}

plugin.js

Raw
/**
 * 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);
  }
})();

README.md

Raw
# 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).