YTMusic Librarian

This skill uses the ytmusicapi Python library to interact with YouTube Music.

Prerequisites

• Python 3.x
• ytmusicapi package: pip install ytmusicapi
• Authentication file (oauth.json or browser.json) in the skill folder.

Setup Instructions

1. Install the library: bash pip install ytmusicapi

2. Generate Authentication (The "cURL Handshake"):

3. Open Microsoft Edge and visit music.youtube.com (ensure you are logged in).
4. Press F12 to open DevTools, go to the Network tab.
5. Click your Profile Icon -> Library on the page.
6. Look for a request named browse in the network list.
7. Right-click the browse request -> Copy -> Copy as cURL (bash).
8. Paste that cURL command into a file named headers.txt in the skill folder.
9. Run the following Python snippet to generate browser.json: python from ytmusicapi.auth.browser import setup_browser with open('headers.txt', 'r') as f: setup_browser('browser.json', f.read())

10. Ensure browser.json is located in the skill folder.

11. Verify: bash python -c "from ytmusicapi import YTMusic; yt = YTMusic('browser.json'); print(yt.get_library_songs(limit=1))"

Workflows

Library Management

• List songs/albums: yt.get_library_songs(), yt.get_library_albums()
• Add/Remove: yt.rate_song(videoId, 'LIKE'), yt.edit_song_library_status(feedbackToken)

Playlist Management

• Create: yt.create_playlist(title, description)
• Add Tracks: yt.add_playlist_items(playlistId, [videoIds])
• Remove Tracks: yt.remove_playlist_items(playlistId, [videoIds])

Metadata & Discovery

• Get Lyrics: yt.get_lyrics(browseId)
• Get Related: yt.get_watch_playlist(videoId) -> related