selecta-youtubelisted

# selecta-youtube **This skill starts audio and opens a visible browser window.** Run it only when the user named a specific recording they want to hear. ``` "${CLAUDE_PLUGIN_ROOT}"/bin/selecta-youtube play "kabza de small - sponono" ``` `selecta play "<a named track>"` routes here on its own once this plugin is installed, so most of the time the plain `selecta` skill is the right entry point and this one is for when the user is explicit. ## The window is not optional YouTube's Developer Policies forbid playing from a player that is not displayed, and set a minimum viewport size. So a small browser window opens and stays visible for as long as the track plays. It cannot be hidden, minimised by selecta, or shrunk, and there is no configuration that changes this. Say this plainly the first time a user is surprised by it. It is a licensing constraint, not a bug and not an oversight. **Never use this skill for an ambient or background request.** A window appearing when someone asked for something to work to is the worst outcome this tool has. ## Setup, and the step everyone misses A free YouTube Data API key is required. Two things must both be true, and only the first is obvious: 1. An API key exists. 2. **YouTube Data API v3 is enabled on that Google Cloud project.** A key without step 2 returns 403 on every single search. Check with: ``` "${CLAUDE_PLUGIN_ROOT}"/bin/selecta-youtube doctor ``` It probes the API rather than reporting the contents of the config file,