Integrations

Integrations

Discord Rich Presence

On by default. Toggle in Settings → Integrations → Discord Rich Presence.

Orchard shows the current track, artist, and artwork in your Discord status, with a link back to an Orchard Song Link for the track. Where a provider has animated cover art, the presence uses it: Apple Music's animated artwork MP4 is converted to a cacheable GIF through Orchard's artwork-proxy worker, since Discord presence assets need a stable image URL.

Discord must be running locally, and its IPC socket must be reachable. Under Flatpak that usually means allowing $XDG_RUNTIME_DIR/discord-ipc-0.

Last.fm

Configure in Settings → Last.fm.

Orchard supports now-playing updates and scrobbling. Authorization happens once, through Last.fm's own flow. Your session key is stored encrypted on your machine.

Orchard's API key and shared secret are never bundled with the app. Requests are signed by Orchard's Last.fm worker, which owns the credentials and forwards to Last.fm over HTTPS. This is why scrobbling depends on that worker being reachable.

Last.fm scrobbling is independent of Replay and of YouTube history. Enabling one does not enable the others.

YouTube listening history

On by default. Toggle in Settings → Integrations → Send listening history to YouTube.

When on, plays update your YouTube account history, which is what keeps YouTube Music's own recommendations aware of what you have been listening to. When off, Orchard plays without reporting back, at the cost of your recommendations going stale.

This is separate from Orchard's local Recently Played and from Replay, both of which keep working either way.

Spotify

Configure in Settings → Spotify.

Orchard can connect to a Spotify account for library and metadata purposes. Note that Spotify's catalog search API is not available to this application, which is why Orchard Song Links fall back to branded Spotify search links rather than direct matches. See Library and Discovery.

GitHub

Orchard's in-app Support System can attribute a report to your GitHub account. That uses a GitHub App with the Device Flow, so you authorize on GitHub's site by code and Orchard never handles a password. Only the app's public client id ships with Orchard; no client secret or private key is bundled.

Signing in is optional. Anonymous reports work.

Orchard account

Settings → Orchard Account manages the identity used by the Support System and by cloud analysis sync.

Service dependencies

Several of these features depend on external services and can stop working when those services change: YouTube Music sign-in, catalog access, playback, live-show discovery, sharing, scrobbling, updates, and support.

BPM and musical-key metadata is provided by GetSongBPM.

Source map

Path	Role
electron/integrations/discordRpc.js	Rich Presence
electron/integrations/lastfm.js	Last.fm auth and scrobbling
electron/integrations/spotify.js	Spotify
electron/integrations/githubAuth.js	GitHub Device Flow
electron/catalog/youtubeHistory.js	YouTube history updates
src/app/social/lastfmScrobbling.js	Scrobble scheduling
workers/lastfm/	Credential-owning Last.fm proxy
workers/artwork-proxy/	Animated artwork to GIF
workers/support/	Support System backend