Configuration

Settings

Accounts, paths, downloads and notifications. Power knobs live on Advanced.

Accounts

Connect an account to import private playlists and saved songs. Public and shared links work without one. MelodyBridge only asks for read access and never changes anything on your account.

Official logins

Spotify connected

Private playlists and liked songs import through this login. Disconnect to revoke it.

YouTube not connected

How to create a YouTube app

Open console.cloud.google.com, create a project, enable the YouTube Data API v3 (APIs & Services, Library), then create OAuth credentials of type Web application (APIs & Services, Credentials).
Add this exact redirect URI to the OAuth client:
http://melodybridge.kohlsalem.com/auth/callback?provider=youtube
Paste the client ID and secret here and click Connect.

Before the first login, open the OAuth consent screen (APIs & Services, OAuth consent screen) and add your own Google account as a Test user: unverified personal apps only work for their test users. You will see an "unverified app" warning: that is expected for a self-hosted personal app; choose Continue to project.

Client ID (Google Cloud Console, OAuth Web application) Client secret

Web sessions

Spotify web session not connected

One sp_dc cookie does both jobs: it lets MelodyBridge fetch public Spotify pages when the normal scrape is blocked, and it powers liked-song and playlist imports on a free account. The public fallback is safe to use; account imports are unofficial and can break, so a burner account is safest. Prefer no cookie at all? The Files tab imports an Exportify CSV.

Spotify web cookie (sp_dc value) I understand account imports are unofficial and may break

Where to find the cookie

Log in at open.spotify.com in a browser.
Open developer tools (F12), then Application or Storage, then Cookies for open.spotify.com.
Copy the value of the cookie named sp_dc and paste it above.

Apple Music not connected

Most Apple Music playlists need no cookie: press Share in Apple Music and paste the link on the Playlists page. Connect a web session only for playlists you have not shared, and to import your saved songs.

Apple Music web cookie (media-user-token value) I understand this is an unofficial session and may stop working

Where to find the cookie

Log in at music.apple.com in a desktop browser.
Open developer tools (F12), then Application or Storage, then Cookies for music.apple.com.
Copy the value of media-user-token and paste it above. A cookies.txt export works too.