Skill v1.0.0
currentAutomated scan100/100version: "1.0.0" name: ytmusic-hub description: Read and write YouTube Music data using Python + ytmusicapi, authenticated via browser cookies obtained automatically with browser_use get_cookies — no manual copying required. Supports fetching playlists, liked songs, playlist details, creating/editing/deleting playlists, searching and adding songs, recommendations, charts, and lyrics. Trigger this skill whenever the user mentions "YouTube Music", "YT Music", "ytmusic", "ytmusic-hub", "get YouTube playlists", "create YouTube Music playlist", "my liked songs", "YTM playlist", or any scenario requiring programmatic read/write access to YouTube Music data.
ytmusic-hub
Interact with YouTube Music using the ytmusicapi library, authenticated via browser cookies. Supports full playlist management, search, liked songs, and more.
Setup
Install dependency
pip install ytmusicapi
Auth file path
/var/minis/workspace/ytmusic_headers.json
Authentication (run before first use or when cookies expire)
Two steps: get cookies → generate auth file.
Step 1: Get cookies
Navigate to YouTube Music and get cookies via browser_use:
browser_use navigate: https://music.youtube.combrowser_use get_cookies -> save env file path
Confirm the page is logged in (avatar visible in top-right), then call get_cookies and note the env file path.
Step 2: Generate auth file
Load the env file and run the auth setup script:
. /var/minis/offloads/env_cookies_youtube_com_xxx.shpython3 /var/minis/skills/ytmusic-hub/scripts/setup_auth.py
The script reads all Cookie env vars and writes a browser-auth file with SAPISIDHASH to /var/minis/workspace/ytmusic_headers.json.
Step 3: Initialize YTMusic client
Use the unified client module — it automatically handles DNS pollution and SSL issues:
import syssys.path.insert(0, "/var/minis/skills/ytmusic-hub/scripts")from ytmusic_client import get_clientyt = get_client()
get_client() will automatically:
- Patch urllib3 to disable SSL certificate verification (required in iSH)
- Detect if local DNS is polluted
- If polluted, resolve the real IP via Google DoH and patch
socket.getaddrinfo - Return a ready-to-use YTMusic instance, or raise
RuntimeErrorwith a clear message
API Reference
📋 Playlist Management
# Get all my playlistsplaylists = yt.get_library_playlists(limit=25)# Returns: [{playlistId, title, count, ...}, ...]# Get playlist contents (all tracks)playlist = yt.get_playlist(playlistId, limit=100)# Returns: {title, description, trackCount, tracks: [{videoId, title, artists, ...}]}# Create a new playlistplaylistId = yt.create_playlist(title="Playlist name",description="Description",privacy_status="PRIVATE" # PUBLIC / PRIVATE / UNLISTED)# Edit playlist metadatayt.edit_playlist(playlistId, title="New name", description="New description")# Delete a playlistyt.delete_playlist(playlistId)# Add songs to a playlistyt.add_playlist_items(playlistId, videoIds=["videoId1", "videoId2"])# Remove songs from a playlist# setVideoId is the track's unique ID within the playlist (different from videoId)tracks = yt.get_playlist(playlistId)["tracks"]yt.remove_playlist_items(playlistId, tracks=[{"videoId": t["videoId"], "setVideoId": t["setVideoId"]}for t in tracks if t["title"] == "Target song"])
❤️ Liked Songs & Library
# Get liked songsliked = yt.get_liked_songs(limit=100)tracks = liked["tracks"] # [{videoId, title, artists, album, ...}]# Get library songs / albums / artistssongs = yt.get_library_songs(limit=25)albums = yt.get_library_albums(limit=25)artists = yt.get_library_artists(limit=25)# Like / unlike a songyt.rate_song(videoId, "LIKE") # LIKE / DISLIKE / INDIFFERENT
🔍 Search
# General search (mixed results)results = yt.search("Jay Chou")# Filter by typesongs = yt.search("Jay Chou", filter="songs")videos = yt.search("Jay Chou", filter="videos")albums = yt.search("Jay Chou", filter="albums")artists = yt.search("Jay Chou", filter="artists")# Get videoId for adding to playlistvideoId = songs[0]["videoId"]
🎵 Browse & Recommendations
# Home feedhome = yt.get_home()# Charts (global or by country)charts = yt.get_charts(country="US") # TW / HK / CN / JP / KR etc.# Mood playlistsmoods = yt.get_mood_categories()mood_playlists = yt.get_mood_playlists(params=moods["Moods & moments"][0]["params"])# Lyricswatch = yt.get_watch_playlist(videoId="videoId")lyrics_id = watch.get("lyrics")if lyrics_id:lyrics = yt.get_lyrics(lyrics_id)print(lyrics["lyrics"])
🎤 Artists & Albums
artist = yt.get_artist(channelId)album = yt.get_album(browseId)user = yt.get_user(channelId)user_playlists = yt.get_user_playlists(channelId, params)
Common Workflows
Workflow A: Search and add a song to a playlist
results = yt.search("Gao Wu Ren - Love Missed", filter="songs")videoId = results[0]["videoId"]playlists = yt.get_library_playlists()for i, pl in enumerate(playlists):print(f"{i+1}. {pl['title']} [{pl['playlistId']}]")yt.add_playlist_items(playlistId, videoIds=[videoId])print("✅ Added to playlist")
Workflow B: Create a playlist from liked songs
new_id = yt.create_playlist("My Favorites", "Picked from liked songs", "PRIVATE")liked = yt.get_liked_songs(limit=50)ids = [t["videoId"] for t in liked["tracks"][:20]]yt.add_playlist_items(new_id, videoIds=ids)print(f"✅ Created playlist with {len(ids)} songs")
Workflow C: Export a playlist as Markdown
playlist = yt.get_playlist(playlistId, limit=200)lines = [f"# {playlist['title']}", f"> {playlist.get('description', '')}", ""]for i, t in enumerate(playlist["tracks"], 1):artists = ", ".join(a["name"] for a in t.get("artists", []))lines.append(f"{i}. **{t['title']}** — {artists}")print("\n".join(lines))
Notes
- Cookie expiry: Cookies typically last days to weeks. Re-run the auth flow when they expire.
- Auth file security:
ytmusic_headers.jsoncontains login credentials — do not share it. - Rate limits: ytmusicapi is unofficial. Avoid bulk operations that may trigger Google's rate limiting.
- Network: Requires access to
music.youtube.com. The client module handles DNS pollution and SSL issues automatically. - videoId vs setVideoId: When removing tracks from a playlist, you must use
setVideoId(the track's position-specific ID), notvideoId.