{"skill":{"slug":"youtube-music","displayName":"YouTube Music ULTRA","summary":"Control YouTube Music with natural language. Play, pause, skip, search, manage playlists, and queue tracks. Full playback control via browser automation.","description":"---\nname: youtube-music\nversion: 1.0.0\ndescription: \"Control YouTube Music with natural language. Play, pause, skip, search, manage playlists, and queue tracks. Full playback control via browser automation.\"\nhomepage: \"https://github.com/paragshah/openclaw-youtube-music\"\nmetadata:\n  {\"clawdbot\":{\"emoji\":\"🎵\",\"category\":\"media\",\"requires\":{\"bins\":[\"node\"],\"env\":[\"YOUTUBE_MUSIC_BROWSER_PROFILE\"]}}}\n---\n\n# YouTube Music Control Skill 🎵\n\nControl YouTube Music with natural language commands. Uses browser automation for full playback control.\n\n## Quick Start\n\n```bash\n# No setup needed - uses OpenClaw browser\n# Optional: Set default profile in TOOLS.md\n```\n\n## Commands\n\n### Playback Control\n- **Play**: \"play [song name]\" / \"play [artist]\" / \"play [playlist]\"\n- **Pause**: \"pause\" / \"stop\"\n- **Resume**: \"resume\" / \"continue\"\n- **Skip**: \"skip\" / \"next\"\n- **Previous**: \"previous\" / \"back\"\n- **Volume**: \"volume 50%\" / \"set volume to 80\"\n- **Mute**: \"mute\" / \"unmute\"\n\n### Search & Discovery\n- **Search**: \"search for [query]\" / \"find [artist]\"\n- **Trending**: \"what's trending\" / \"trending now\"\n- **Recommendations**: \"recommend similar\" / \"more like this\"\n\n### Library & Playlists\n- **Playlists**: \"show my playlists\" / \"create playlist [name]\"\n- **Add to Playlist**: \"add this to [playlist]\"\n- **Liked Songs**: \"show liked songs\" / \"like this\"\n\n### Queue Management\n- **Queue**: \"show queue\" / \"what's next\"\n- **Add to Queue**: \"queue [song]\"\n- **Clear Queue**: \"clear queue\"\n\n### Information\n- **Now Playing**: \"what's playing\" / \"current track\"\n- **Lyrics**: \"show lyrics\" / \"lyrics\"\n- **Artist Info**: \"about [artist]\"\n\n## Usage Examples\n\n```\n\"play Ye Tune Kya Kiya by Javed Bashir\"\n\"pause the music\"\n\"skip to next track\"\n\"set volume to 75%\"\n\"search for Arijit Singh hits\"\n\"add this to my workout playlist\"\n\"what's playing now?\"\n\"show me the lyrics\"\n\"queue some chill Bollywood songs\"\n```\n\n## Implementation Notes\n\n### Browser Automation\nUses OpenClaw's browser tool with YouTube Music:\n- Profile: `openclaw` (isolated browser)\n- Base URL: `https://music.youtube.com`\n- CDP Port: 18800\n\n### Key Selectors (Dynamic)\nSelectors are resolved via snapshot refs, not hardcoded:\n- Player controls: pause, play, skip, previous\n- Search box: combobox with placeholder\n- Volume slider: range input\n- Queue: up next panel\n- Lyrics: lyrics tab\n\n### Error Handling\n- Browser not running → Auto-start\n- Video unavailable → Suggest alternatives\n- Network issues → Retry with backoff\n- No search results → Show spelling suggestions\n\n## Advanced Features\n\n### Smart Search\n- Fuzzy matching for song names\n- Artist/album disambiguation\n- Auto-play top result if exact match\n\n### Context Awareness\n- Remembers last played track\n- Tracks listening history\n- Suggests based on time of day\n\n### Multi-Room Support\n- Cast to different devices\n- Sync playback across tabs\n- Group control (future)\n\n## Configuration\n\nAdd to `TOOLS.md`:\n```markdown\n### YouTube Music\n- Default profile: openclaw\n- Preferred quality: high\n- Auto-play: on\n- Shuffle default: off\n```\n\n## Dependencies\n- OpenClaw browser tool\n- YouTube Music (music.youtube.com)\n- No API keys required\n\n## Limitations\n- Requires browser to be running\n- Some features need YouTube Premium\n- Lyrics availability varies by region\n- Queue management limited to current session\n\n## Future Enhancements\n- YouTube Music API integration (if available)\n- Offline mode with cached tracks\n- Cross-platform sync\n- Voice control integration\n- Smart playlists based on mood/activity\n\n## Examples\n\n### Play a Song\n```\nUser: \"play Tuna Kay Keya\"\nAssistant: \"Found 'Ye Tune Kya Kiya' by Javed Bashir. Playing now! 🎵\"\n```\n\n### Control Playback\n```\nUser: \"pause\"\nAssistant: \"Paused. Press play to resume. ⏸️\"\n\nUser: \"skip\"\nAssistant: \"Skipping to next track. ⏭️\"\n```\n\n### Search & Discover\n```\nUser: \"find similar to this\"\nAssistant: \"Based on 'Ye Tune Kya Kiya', you might like:\n- 'Kaise Hua' by Vishal Mishra\n- 'Aankhon Se Batana' by Dikshant\n- 'Kali Kali Zulfon Ke' by Madhur Sharma\"\n```\n\n### Playlist Management\n```\nUser: \"add this to my Bollywood Classics\"\nAssistant: \"Added 'Ye Tune Kya Kiya' to 'Bollywood Classics' playlist. ✓\"\n```\n\n## Testing\n\nTest the skill with:\n```bash\n# Test search\n\"search for Pritam songs\"\n\n# Test playback\n\"play a sample track\"\n\"pause\"\n\"skip\"\n\n# Test volume\n\"set volume to 50%\"\n\"mute\"\n\"unmute\"\n```\n\n---\n\n**Skill Author:** Your AI Assistant  \n**License:** MIT  \n**Status:** Ready for production 🚀\n","topics":["Music","Browser Automation"],"tags":{"latest":"3.0.0"},"stats":{"comments":0,"downloads":867,"installsAllTime":33,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1772118423999,"updatedAt":1779077332827},"latestVersion":{"version":"3.0.0","createdAt":1772118423999,"changelog":"v3.0 ULTRA FAST: 95% faster, direct video ID support, smart caching, atomic play actions, fuzzy matching","license":null},"metadata":{"setup":[{"key":"YOUTUBE_MUSIC_BROWSER_PROFILE","required":true}],"os":null,"systems":null},"owner":{"handle":"oki3505f","userId":"s172b99x0vgz561j4w455a82b983hkgr","displayName":"om yarewara","image":"https://avatars.githubusercontent.com/u/186946154?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779962718849}}