-
Notifications
You must be signed in to change notification settings - Fork 0
Discovery
Discovery finds new YouTube channels based on your existing library. It uses heuristic scanning to identify channels that are related to the ones you already follow, then presents them as suggestions you can accept or dismiss.
Discovery runs two generators against your existing sources:
- G1 (Mention Mining) — scans video descriptions and metadata across your library for references to other YouTube channels. Channels that are mentioned frequently across multiple sources score higher.
- G2 (Featured Channels) — crawls the "Featured Channels" section on each of your subscribed channel pages. Channels featured by multiple sources score higher.
Candidates from both generators are merged, validated via yt-dlp (confirms the channel exists and fetches subscriber count, video count, etc.), scored with tier balancing, and saved to a suggestion pool.
Channels you already have as sources are automatically excluded, as are channels you've previously dismissed.
Navigate to Discovery in the sidebar to see your suggestions.
- The page displays 10 random suggestions from the pool (up to 50 validated candidates)
- The header shows "Showing X of Y suggestions" so you know the pool size
- Refresh picks a different random set of 10 from the pool
- Scan Now triggers a new scan in the background — a spinner banner appears while it runs, and the page updates automatically when it finishes
- Scans run in the background and persist even if you navigate away from the page
Click Accept to add a channel as a new source. This takes you to the source creation form with the channel URL, name, and source type pre-filled. Complete the form to start downloading from that channel.
Click Dismiss to remove a suggestion. Dismissed channels are excluded from all future scans and will not reappear. You can restore dismissed channels from Settings (see below).
Discovery runs an automatic scan every day at 03:00 UTC to keep the suggestion pool fresh. You can also trigger a scan manually at any time using the Scan Now button.
Go to Settings → Discovery to configure:
- Enable Discovery — master toggle for the entire feature
- G1 (Mention Mining) — enable or disable the mention mining generator
- G2 (Featured Channels) — enable or disable the featured channels generator
- G3 and G4 — planned generators (not yet available)
At the bottom of the Discovery settings tab, you can see a list of all channels you've dismissed. Click Restore on any channel to return it to the suggestion pool so it can appear on the Discovery page again.
- The more sources you have, the better Discovery works — it needs existing channels to find relationships
- After your first scan, hit Refresh a few times to browse different suggestions from the pool
- If you're not seeing enough suggestions, make sure both G1 and G2 are enabled in Settings
- Scans take 3–5 minutes depending on the size of your library (yt-dlp needs to validate each candidate)