BLXAde’s Music feature is YouTube-only. Spotify is out of scope. There is one app-wide playback session and at most one Music mirror node per project.

Connect YouTube

Settings → Connections → YouTube, or onboarding Optional settings
Start OAuth (system browser + device/desktop flow)
Wait until the card shows connected (status polls while waiting)
You can skip onboarding Music and connect later

Tokens live in the OS keyring. The webview never holds the refresh token.

Replay onboarding or Clear local history closes the Music session and deletes the YouTube keyring record. Clearing only recents does not disconnect Music. If secure-delete fails, Settings stays open with an error.

Canvas node

Action	Effect
Open	Create/focus this project’s mirror; reuse global session
Remove	Delete this project’s mirror only
Close (session)	Stop session, invalidate mirrors
Stop	Cue current track to start
Header Screenshot / Move to	Presentation only (no Handoff)

Default size is large enough for the embed; very small sizes pause with a resize hint. There is no auto-resume of playback after app restart.

Controls and playlists

Search, playlists, and player chrome live in the node UI
Provider playlists are source of truth — BLXAde does not keep a local queue of tracks
Procedural spectrum visualizer is playback-synced (theme-colored); it is not a raw YouTube FFT dump

Volume and Sound Settings

Music has its own source volume/mute on the node. The global Sound mixer composes:

effective = Master × Music lane × source volume × mute

The node continues to show the user-owned source volume while the host applies the effective level live.

Global Agent tools

Music control tools are Global Agent only (not External MCP). Agents can drive playback when authorized; they never receive raw OAuth credentials.

Tips

Google OAuth test mode requires your account as a test user on the Google Cloud project that owns the desktop client.
If connection sticks on waiting, cancel and retry; check system browser blockers.
Host transfer between project mirrors may require a user gesture to resume play.

Music