feat: YouTube video/music search in panel (yt-dlp ytsearch) + toggle

[aarontanx]

feat: YouTube video/music search in panel (yt-dlp ytsearch) + toggle

Fixes panel only showing playlists when [ytmusic] is enabled — no video/music results, even though TUI Ctrl+F does search YouTube.

Problem

cliamp-library only spoke Subsonic (/rest/stream token → search3/getAlbumList2). With no Navidrome host (e.g. config.toml only has [ytmusic] enabled=true and radio), server_from() returned None and search printed []. Playlists still appeared via Model.matchPlaylists() from cliamp playlist list, so users saw “only playlists from YouTube Music” and no video/music results — even though cliamp TUI Ctrl+F provider-search (strings ytsearch1:/ytsearch10:) does search YouTube via yt-dlp.

Socket has no search command ({"cmd":"search"} → unknown command), so panel had no YouTube path.

Solution

Mirror TUI's YouTube search in the panel using the same yt-dlp backend the youtube provider uses, with a toggle.

• cliamp-library

  • Add YT_SEARCH_LIMIT=8, YT_SEARCH_TIMEOUT=15, yt_search(query) → yt-dlp --flat-playlist --print-json ytsearchN:query (NDJSON). Filters channels (ie_key==YoutubeTab, channel URLs, non-11-char IDs) and keeps only videos (ie_key==Youtube + watch?v=). Returns kind:"youtube" rows with url. Never raises — missing yt-dlp returns [] so Subsonic outage doesn't blank panel.
  • Add play_youtube(id, title, artist) → writes ~/.config/cliamp/playlists/cliampui.toml with path="https://www.youtube.com/watch?v=ID" (cliamp youtube provider resolves via yt-dlp), then cliamp load cliampui.
  • main(): play-youtube/play-yt handled without Subsonic host; albums/search no longer early-exit on missing host — they return Subsonic rows (or []) and still run yt_search. search merges search3 + yt_search and honors --no-youtube flag.

• Model.js

  • parseResults handles kind=="youtube" (conditional url to keep tests/model.test.js green).

• Service.qml

  • playResult() routes youtube → [libraryHelper, "play-youtube", id, name, artist].
  • enableYoutubeSearch: boolSetting("enableYoutubeSearch", true), _dispatchLibrary() adds --no-youtube when disabled, and filters youtube rows post-parse as safety.

• manifest.json + README.md

  • New setting enableYoutubeSearch (boolean, default true, schema + defaults), settings table updated.

• Library.qml

  • Placeholder Search songs, albums, playlists and YouTube.
  • Inline YouTube search ON/OFF row (CursorSurface) + toggleYoutubeRequested signal.

• Panel.qml

  • Handles onToggleYoutubeRequested: toggles enableYoutubeSearch via root.settings + bar.shell.updateEntryInline and re-triggers current search.

Toggle

Settings UI (auto-generated from manifest.json schema) → Search YouTube in library (default ON). Or inline:

• Library → YouTube search ON/OFF row (click to toggle, persists)
• CLI:

  omarchy bar set io.github.thisisgm.cliampui enableYoutubeSearch false --json
  omarchy bar set io.github.thisisgm.cliampui enableYoutubeSearch true --json
  omarchy restart shell # or toggle via library row (no restart needed, re-searches)

When OFF, cliamp-library search --no-youtube skips yt-dlp entirely (no network, no delay) and panel shows only Subsonic + playlists, like before.

Testing

python3 cliamp-library search "rick astley" | jq # 7 youtube rows (channel filtered)
python3 cliamp-library search "rick astley" --no-youtube | jq # 0 (no Subsonic host)
python3 cliamp-library play-youtube dQw4w9WgXcQ "Never Gonna Give You Up" "Rick Astley"
cat ~/.config/cliamp/playlists/cliampui.toml # [[track]] path youtube
cliamp status --json | jq # playing, stream true, duration 213
deno run --allow-read tests/model.test.js # all model tests passed
omarchy plugin validate ~/.config/omarchy/plugins/io.github.thisisgm.cliampui # exit 0
omarchy restart shell

Panel: search “lofi” → YOUTUBE rows appear alongside album/song/playlist when ON, disappear when OFF; toggle via library row instantly refreshes; Enter plays immediately (daemon stays, no TUI kill).

Notes

• Requires yt-dlp on PATH (already used by cliamp's youtube provider, 2026.08.19 tested). If missing, falls back to Subsonic only.
• Clamped to 3–15 results to keep 260 ms debounce responsive; albumProcess single-flight prevents overlapping yt-dlp runs.
• No credential handling — same as TUI ytsearch, uses anonymous YouTube search.
• play-youtube accepts full URL as well.

Closes the reported issue: search now finds YouTube videos/music just like TUI Ctrl+F, with toggle to keep it Subsonic-only.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: 010c774d-41e2-4d4d-8eb1-d6203e255e8e

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}