Listening Post › Shortcuts

The Shortcuts channel lets you name Shortcuts workflows which will be run automatically, manually from the track menu, or when you like/unlike/delete a track.

The triggered workflow receives the full track data set as "File" input. That "file" is a Shortcuts dictionary.

Automatic workflow runs

When enabled, the workflow run happens after the track is recognized, once the publishing delay is over.

Running the manual workflow

This becomes possible once the track is fully recognized and enriched. The enrichment usually takes just a few seconds, and mostly depends on the channels you've enabled (Last.fm, ListenBrainz etc.).

Running workflow triggers

The "Workflow Triggers" section lets you set workflows that are automatically run when you like, unlike, or delete (forget) a track.

Likes and unlikes have a 5-second delay so rapid toggling Like cancels out.

Configuration

Find the configuration in the Channels tab → "Shortcuts".

Data format

Listening Post will send the full track info to the configured workflow, as JSON. Shortcuts can accept it as "File", and will automatically turn it into a dictionary (key/value pairs). Here's an example output that the workflow would receive:

Minimum output (no enrichment channels active)

{
  "albumTitle": "Ooh La La",
  "appleMusicID": "1031010969",
  "appleMusicURL": "https://music.apple.com/de/album/ooh-la-la/1031010809?i=1031010969&l=en-GB",
  "artist": "Faces",
  "artworkURL": "https://is1-ssl.mzstatic.com/image/thumb/Music124/v4/c0/40/f9/c040f938-aa57-33c0-99e0-45be2ab9f350/603497886272.jpg/800x800bb.jpg",
  "durationSeconds": 213,
  "enrichments": {},
  "explicitContent": null,
  "genres": ["Pop"],
  "id": "8434AAE3-96A7-4B9C-8335-85A652785079",
  "isLiked": false,
  "isrc": "USWB11400861",
  "recognizedAt": "2026-03-16T10:46:41Z",
  "releaseYear": 1973,
  "shazamID": "330957",
  "title": "Ooh La La"
}

Maximum output (all 5 enrichment channels active)

{
  "albumTitle": "DON'T TAP THE GLASS",
  "appleMusicID": "1827715797",
  "appleMusicURL": "https://music.apple.com/de/album/ring-ring-ring/1827715784?i=1827715797&l=en-GB",
  "artist": "Tyler, The Creator",
  "artworkURL": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/a0/ae/e6/a0aee657-b365-fed2-249c-0f22efa507d0/196873435435.jpg/800x800bb.jpg",
  "durationSeconds": 201,
  "enrichments": {
    "deezer": {
      "albumTitle": "DON'T TAP THE GLASS",
      "artworkURL": "https://cdn-images.dzcdn.net/images/cover/d79052872c09468fd80bd288928962c9/1000x1000-000000-80-0-0.jpg",
      "id": "3470152981",
      "releaseYear": 2025,
      "url": "https://www.deezer.com/track/3470152981"
    },
    "lastfm": {
      "albumTitle": "DON'T TAP THE GLASS",
      "artworkURL": "https://lastfm.freetls.fastly.net/i/u/300x300/78e70997eda194526a71b0ed3fa411f0.png",
      "id": null,
      "releaseYear": null,
      "url": "https://www.last.fm/music/Tyler,+The+Creator/_/Ring+Ring+Ring"
    },
    "listenbrainz": {
      "albumTitle": "DON'T TAP THE GLASS",
      "artworkURL": null,
      "id": "9b3393c6-2e66-4be0-a8fc-320ddae2b99e",
      "releaseYear": null,
      "url": "https://listenbrainz.org/recording/9b3393c6-2e66-4be0-a8fc-320ddae2b99e"
    },
    "rocksky": {
      "albumTitle": "DON'T TAP THE GLASS",
      "artworkURL": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:aipjn3ze7k2bzyohekpiwahz/bafkreic22pbbq23dexgccmf4rsivu5d7dkejdd5esoaioovaae6boow6qq@jpeg",
      "id": null,
      "releaseYear": null,
      "url": "https://rocksky.app/did:plc:aipjn3ze7k2bzyohekpiwahz/song/3lzq76pcauk2y"
    },
    "spotify": {
      "albumTitle": "DON'T TAP THE GLASS",
      "artworkURL": "https://i.scdn.co/image/ab67616d0000b2734b7fbb849ed845ddedcce346",
      "id": "1lTqq0aC6r2bXLviQ3oaVt",
      "releaseYear": 2025,
      "url": "https://open.spotify.com/track/1lTqq0aC6r2bXLviQ3oaVt"
    }
  },
  "explicitContent": null,
  "genres": ["Rap"],
  "id": "C82AF1B4-03CD-4F9A-BA60-97016F0B41A9",
  "isLiked": false,
  "isrc": "USQX92503274",
  "recognizedAt": "2026-03-15T18:01:14Z",
  "releaseYear": 2025,
  "shazamID": "832706778",
  "title": "Ring Ring Ring"
}

One enrichment channel active (e.g., Spotify only)

{
  "albumTitle": "Speak for Yourself (Deluxe Version)",
  "appleMusicID": "1785686649",
  "appleMusicURL": "https://music.apple.com/de/album/hide-and-seek/1785686643?i=1785686649&l=en-GB",
  "artist": "Imogen Heap",
  "artworkURL": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/98/85/1e/98851e09-6760-85e1-c1ef-e1034f6a7cb8/886445364712_cover.jpg/800x800bb.jpg",
  "durationSeconds": 268,
  "enrichments": {
    "spotify": {
      "albumTitle": "Speak for Yourself (Deluxe Version)",
      "artworkURL": "https://i.scdn.co/image/ab67616d0000b2730cabafb8b01b956fae313c57",
      "id": "2tej1KSqNuxwywIpY1rDRc",
      "releaseYear": 2005,
      "url": "https://open.spotify.com/track/2tej1KSqNuxwywIpY1rDRc"
    }
  },
  "explicitContent": null,
  "genres": ["Pop"],
  "id": "70410BD7-B4C6-4ED2-B371-0FB6AEA19796",
  "isLiked": false,
  "isrc": "GBJPX0500005",
  "recognizedAt": "2026-03-15T20:04:42Z",
  "releaseYear": 2005,
  "shazamID": "41368446",
  "title": "Hide and Seek"
}

Shortcuts example

Each of these field/value pairs will become an entry in the dictionary. In the example below, both the "artist" and "title" values are used to build a simple text, which is then shown as an alert:

When this "LP: Manual" workflow (just an example name, you do you!) is run from the track menu, it'll show an example alert:

If you want to go access nested data from the structure, use JSON key path notation to target the specific data field. For example, if you want to access the Spotify ID from the last of the above examples, you'd use enrichments.spotify.id.

How can I help?