Connect your Spotify account
Import playlists directly from Spotify. Each track is matched and downloaded from YouTube automatically.
Before connecting, add this Redirect URI to your
Spotify Developer Dashboard
β your app β Edit Settings β Redirect URIs:
Spotify not configured
Add SPOTIFY_ID and SPOTIFY_SECRET
to your .env.mac file, then rebuild.
Get credentials at developer.spotify.com.
Last.fm
The API key fills in genres when Spotify has none (set LASTFM_APIKEY in .env).
Connect stores a session (needs LASTFM_SECRET + callback URL) for future features like scrobbling.
Genre fallback uses Last.fm tag heuristics in Music Searcher (not a separate beets pipeline). Empty or nonsense embedded genres are stripped so Spotify/Last.fm can fill them.
API key is not set. Add LASTFM_APIKEY to your environment and restart.
Connect your YouTube account
Import playlists directly from YouTube and map tracks to Spotify metadata before queueing downloads.
Before connecting, add this Redirect URI to your Google OAuth client:
YouTube OAuth not configured
Add YOUTUBE_CLIENT_ID and YOUTUBE_CLIENT_SECRET
to your .env.mac file, then rebuild.
YouTube Cookie Profiles
How to get cookies: Install Get cookies.txt LOCALLY (Chrome) or cookies.txt (Firefox). Sign into YouTube as the desired account, export cookies to a
.txt file, then upload it to the matching profile below. The
active profile is used automatically for downloads and cookie-based playlist access.
π― Create new Google account for music training β
Download Queue
System
Library maintenance, source-feedback insights, long-running operations, metrics, and API keys.
Completed library imports with the YouTube source used. Rate after listening β survives queue clear.