Now Playing GitHub

Windows · Stream Deck plugin

Apple Music, live on your Stream Deck.

Full-bleed album art on the encoder screen, a scrubbing dial, per-app volume, and one-tap playlists — control Apple Music for Windows without ever touching your keyboard.

Cover of “Blinding Lights” by The Weeknd
Blinding LightsThe Weeknd
  • Windows 10 / 11
  • Stream Deck 6.5+
  • SMTC · Core Audio · UI Automation
  • MIT licensed

Features · Side A / Side B

Everything the dial and the keypad can do.

  1. Now Playing, full bleed

    Album cover fills the encoder screen, with a pause overlay when playback stops. Single click plays or pauses, double click skips forward, triple click goes back, and turning the dial moves between tracks.

  2. Multi-artist titles, cleaned up

    A comma-separated pile of names becomes Main artist feat. Second, Third, and the title scrolls in a smooth circular loop — with a 2 second pause on every lap — whenever it overflows the screen.

  3. Volume that targets the app

    Volume up, down, and mute act on Apple Music's own entry in the Windows volume mixer — your system volume and every other app stay untouched.

  4. One tap actually starts playback

    A button whose icon is the playlist or album cover opens the music:// link and drives Apple Music's own Play button through UI Automation — not a link that just opens a browser tab.

  5. Built on native Windows APIs

    Title, artist, cover art and position come from SMTC — the same API behind Windows' own now-playing widget — read through a small C# bridge the Node/TypeScript plugin queries.

  6. A full keypad, not just a dial

    Play/Pause, Previous, and Next as standalone Stream Deck buttons — for setups without an encoder, or when reaching for the dial is one gesture too many.

Hardware

Works on any Elgato Stream Deck — even the one built into a keyboard.

Anything running Elgato's Stream Deck software can host these actions — a standalone Stream Deck+, or a full mechanical keyboard with one embedded, like Corsair's Galleon 100 SD: 12 Stream Deck keys, two rotary dials, and a 720×180 display, sitting right above the keys you already type on.

Elgato Explorer
Cover of “Blinding Lights” by The Weeknd
Blinding LightsThe Weeknd
Album cover of Currents by Tame Impala: a metallic sphere on a purple and black optical-illusion landscape
Playlist cover: two empty white plastic chairs in front of banana plants
Album cover of Nevermind by Nirvana: a baby swimming underwater toward a dollar bill on a fishing hook
Album cover of Demon Days by Gorillaz: four cartoon band members in a 2 by 2 grid
Album cover of Starboy by The Weeknd: a man in a dark leather jacket holding his head, lit in blue
Album cover of Toxicity by System of a Down: the band name in large white letters on a dry hillside
Corsair Galleon 100 SD — 2 dials, a 4-zone screen & 12 playback / playlist keys, illustrated

How it works

No scraping, no polling the UI — just the OS's own hooks.

A small C# executable, NowPlayingBridge.exe, does the Windows-side work and gets queried by the Node/TypeScript plugin that runs on your Stream Deck.

  1. Read

    SMTC

    Windows.Media.Control exposes title, artist, cover art and playback position — the same system feed behind Windows' own now-playing widget.

  2. Control

    Core Audio

    ISimpleAudioVolume targets Apple Music's own audio session — the programmatic twin of the per-app slider in the Windows volume mixer.

  3. Bridge

    NowPlayingBridge.exe

    A small C# executable wraps SMTC, Core Audio and UI Automation, and is queried by the Node/TypeScript plugin — the part Stream Deck actually runs.

Get it running

Two ways in — pick yours.

No dev tools

Simple install

  1. Download now-playing.streamDeckPlugin from the repo.
  2. Double-click it — Stream Deck installs it automatically.
Download the plugin

For developers

Local install

git clone https://github.com/Alexis-VS-CSharp/streamdeck-nowplaying.git
cd streamdeck-nowplaying
npm install
npm run build
npx streamdeck link com.alexisvscsharp.nowplaying.sdPlugin

Restart the Stream Deck app — the actions show up under Apple Music Now Playing. npm run watch rebuilds and restarts on every change.

Requirements before you install

  • Windows 10 / 11
  • Stream Deck software 6.5+
  • Apple Music for Windows, signed in
  • Node.js 20+ to build from source

Worth knowing

Shuffle and Repeat can't be triggered — Apple Music for Windows doesn't expose them over SMTC. That's the app's ceiling, not the plugin's.

If something like SteelSeries Sonar remixes audio after Windows, volume control acts on the Windows session — not that software's own internal fader.

Plug your music into your deck.

Free, open source, MIT licensed.