- name
- youtube-music
- version
- 1.0.0
- description
- Control YouTube Music with natural language. Play, pause, skip, search, manage playlists, and queue tracks. Full playback control via browser automation.
- homepage
- https://github.com/paragshah/openclaw-youtube-music
- metadata
YouTube Music Control Skill 🎵
Control YouTube Music with natural language commands. Uses browser automation for full playback control.
Quick Start
# No setup needed - uses OpenClaw browser
# Optional: Set default profile in TOOLS.mdCommands
Playback Control
- Play: "play [song name]" / "play [artist]" / "play [playlist]"
- Pause: "pause" / "stop"
- Resume: "resume" / "continue"
- Skip: "skip" / "next"
- Previous: "previous" / "back"
- Volume: "volume 50%" / "set volume to 80"
- Mute: "mute" / "unmute"
Search & Discovery
- Search: "search for [query]" / "find [artist]"
- Trending: "what's trending" / "trending now"
- Recommendations: "recommend similar" / "more like this"
Library & Playlists
- Playlists: "show my playlists" / "create playlist [name]"
- Add to Playlist: "add this to [playlist]"
- Liked Songs: "show liked songs" / "like this"
Queue Management
- Queue: "show queue" / "what's next"
- Add to Queue: "queue [song]"
- Clear Queue: "clear queue"
Information
- Now Playing: "what's playing" / "current track"
- Lyrics: "show lyrics" / "lyrics"
- Artist Info: "about [artist]"
Usage Examples
"play Ye Tune Kya Kiya by Javed Bashir"
"pause the music"
"skip to next track"
"set volume to 75%"
"search for Arijit Singh hits"
"add this to my workout playlist"
"what's playing now?"
"show me the lyrics"
"queue some chill Bollywood songs"Implementation Notes
Browser Automation
Uses OpenClaw's browser tool with YouTube Music:
- Profile:
openclaw(isolated browser) - Base URL:
https://music.youtube.com - CDP Port: 18800
Key Selectors (Dynamic)
Selectors are resolved via snapshot refs, not hardcoded:
- Player controls: pause, play, skip, previous
- Search box: combobox with placeholder
- Volume slider: range input
- Queue: up next panel
- Lyrics: lyrics tab
Error Handling
- Browser not running → Auto-start
- Video unavailable → Suggest alternatives
- Network issues → Retry with backoff
- No search results → Show spelling suggestions
Advanced Features
Smart Search
- Fuzzy matching for song names
- Artist/album disambiguation
- Auto-play top result if exact match
Context Awareness
- Remembers last played track
- Tracks listening history
- Suggests based on time of day
Multi-Room Support
- Cast to different devices
- Sync playback across tabs
- Group control (future)
Configuration
Add to TOOLS.md:
### YouTube Music
- Default profile: openclaw
- Preferred quality: high
- Auto-play: on
- Shuffle default: offDependencies
- OpenClaw browser tool
- YouTube Music (music.youtube.com)
- No API keys required
Limitations
- Requires browser to be running
- Some features need YouTube Premium
- Lyrics availability varies by region
- Queue management limited to current session
Future Enhancements
- YouTube Music API integration (if available)
- Offline mode with cached tracks
- Cross-platform sync
- Voice control integration
- Smart playlists based on mood/activity
Examples
Play a Song
User: "play Tuna Kay Keya"
Assistant: "Found 'Ye Tune Kya Kiya' by Javed Bashir. Playing now! 🎵"Control Playback
User: "pause"
Assistant: "Paused. Press play to resume. ⏸️"
User: "skip"
Assistant: "Skipping to next track. ⏭️"Search & Discover
User: "find similar to this"
Assistant: "Based on 'Ye Tune Kya Kiya', you might like:
- 'Kaise Hua' by Vishal Mishra
- 'Aankhon Se Batana' by Dikshant
- 'Kali Kali Zulfon Ke' by Madhur Sharma"Playlist Management
User: "add this to my Bollywood Classics"
Assistant: "Added 'Ye Tune Kya Kiya' to 'Bollywood Classics' playlist. ✓"Testing
Test the skill with:
# Test search
"search for Pritam songs"
# Test playback
"play a sample track"
"pause"
"skip"
# Test volume
"set volume to 50%"
"mute"
"unmute"Skill Author: Your AI Assistant License: MIT Status: Ready for production 🚀