ytmusic-hub

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.com
browser_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.sh
python3 /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 sys
sys.path.insert(0, "/var/minis/skills/ytmusic-hub/scripts")
from ytmusic_client import get_client

yt = get_client()

get_client() will automatically:

1. Patch urllib3 to disable SSL certificate verification (required in iSH)
2. Detect if local DNS is polluted
3. If polluted, resolve the real IP via Google DoH and patch socket.getaddrinfo
4. Return a ready-to-use YTMusic instance, or raise RuntimeError with a clear message

---

API Reference

📋 Playlist Management

# Get all my playlists
playlists = 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 playlist
playlistId = yt.create_playlist(
    title="Playlist name",
    description="Description",
    privacy_status="PRIVATE"  # PUBLIC / PRIVATE / UNLISTED
)

# Edit playlist metadata
yt.edit_playlist(playlistId, title="New name", description="New description")

# Delete a playlist
yt.delete_playlist(playlistId)

# Add songs to a playlist
yt.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"
])