Cue for Apple Music 1.0.0
A Stream Deck plugin for the macOS Music app.

This is a plugin I created for my personal use and released to the public in-case it's
useful to anyone else. It is not supported software, and I make no guarantees on
performance or future releases.


INSTALL

1. Double-click org.casabona.cue.streamDeckPlugin.
   Stream Deck installs it and adds a "Cue for Apple Music" category to the
   actions list on the right.

2. Drag any action onto a key.

3. The first time you press one, macOS asks whether Stream Deck may control
   Music. Say OK. Nothing works until you do.

   If you miss the prompt, turn it on in System Settings > Privacy & Security >
   Automation > Stream Deck > Music.


WHAT YOU GET

Keys
  Play / Pause      Shows the current album art. Paused dims the cover behind a
                    play triangle; playing adds a small pause badge.
  Next Track
  Previous Track    Restarts the track, or steps back if you are in the first
                    three seconds.
  Shuffle           Reflects Music's real state, not the last thing you pressed.
  Repeat            Cycles off, all, one.
  Favorite          Favorites the track that is playing.
  Playlist          One press starts a playlist you pick, shuffled if you want.

Dials (Stream Deck + only)
  Volume            Turn for volume, press to play or pause, tap to skip.
  Transport         Turn to change track, press or tap to play or pause. The
                    touch strip shows the track and artist.

Each key has its own settings; select it in the Stream Deck app to see them.


REQUIREMENTS

  macOS 12 or later
  Stream Deck 6.5 or later
  The two dial actions need a Stream Deck +


IF SOMETHING LOOKS WRONG

Album art stays a plain icon
  The track has no artwork, or Music will not identify it. On macOS 26 and
  later, Music sometimes refuses to report the current track for Apple Music
  catalogue songs and anything started from Home, Radio, or Recently Added.
  Playback controls still work.

A key does nothing
  Check the Automation permission above.

Anything else
  The log is at:
  ~/Library/Logs/ElgatoStreamDeck/

  It names which readings Music refused, which is usually the whole answer.


PRIVACY

Runs entirely on your Mac through the Music app's own scripting interface.
No account, no sign-in, no network access, no telemetry.


SOURCE

https://github.com/jcasabona/cue-for-apple-music

MIT licensed.


Cue is an independent plugin for use with Apple Music. It is not affiliated
with, endorsed by, or produced by Apple Inc. or Elgato. Apple Music is a
trademark of Apple Inc. Stream Deck is a trademark of Elgato.
