Now Playing Integrations

Now Playing Integrations

The Now Playing module displays track metadata, cover art, progress, and transport controls from supported local providers. It is independent of Prism's audio capture: the song shown does not determine which device the analyzers hear.

Showing the module

Enable Now Playing under Settings > Modules. Its display controls can independently show or hide:

• Cover;
• Title;
• Artist;
• Bar;
• Time;
• Controls.

All six are enabled by default. Hide elements to make a compact ticker or cover-only popout.

Provider priority

Open Settings > Now Playing and drag providers into priority order. Prism evaluates available providers in that order. The highest-priority configured provider that begins playing takes control immediately.

Priority is useful when more than one supported player is open. It is not a playlist order and does not start an application by itself.

Astra

Astra integration reads Astra's local API and can send supported previous, play/pause, and next commands.

The default server address is:

http://127.0.0.1:38401

Enter the address and Astra API token, then save. The token is stored through the operating system's secure credential storage rather than in a Prism profile.

• Leaving the token box blank when saving keeps the token already stored.
• Clear Token removes the stored credential.
• A custom address is useful only when Astra has deliberately been exposed at another trusted address.

Prism connects to Astra only while the Now Playing module is visible in the rack or detached into its own window. Hiding the module stops that live connection.

Spotify

Spotify uses local operating-system playback integration and does not require a Spotify developer API key.

• macOS reads Spotify.app and may request Automation permission.
• Linux uses the MPRIS media interface.
• Windows uses the system media session.

Metadata and controls depend on what the installed Spotify client and operating system expose. If controls are unavailable for a particular session, the buttons remain disabled rather than guessing.

TIDAL

TIDAL is shown for future priority configuration but is currently Coming soon and unavailable as a functional provider. Moving its row does not enable metadata or controls.

Provider status

The settings page can show a provider as idle, connecting, connected/live, unavailable, or in error. Use Retry after correcting a temporary application, permission, network, or credential problem. Use Configure when the provider needs settings.

The transport controls are enabled only when an active provider reports that the corresponding action is supported.

Security and privacy

• Keep Astra bound to localhost unless remote access is intentionally secured.
• Treat an Astra API token like a password; do not put it in screenshots, themes, profiles, or bug reports.
• Provider credentials are not included in .prsm files.
• Linux secure storage requires a supported desktop keyring. Prism reports an error rather than writing a secret insecurely when no supported keyring is available.

Troubleshooting metadata

If the module is empty or stale:

1. Confirm the module is enabled or detached and visible.
2. Confirm the intended provider is playing and is above other active providers in priority.
3. Open provider settings and check its status.
4. For Astra, confirm Astra's local API is enabled, the address is reachable, and the token is current.
5. For Spotify on macOS, review Automation permission for Prism; on Linux, confirm the player exposes an MPRIS session.
6. Select Retry after changing the provider state.

See Troubleshooting for operating-system permission and secure-storage guidance.