whatisgithub

What is spatial-relay?

shevlfs/spatial-relay — explained in plain English

Analysis updated 2026-05-18

1SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A macOS menu bar app that routes Spotify audio through Apple's Spatial Audio playback path for supported AirPods.

Mindmap

mindmap
  root((repo))
    What it does
      Taps Spotify audio
      Routes to spatial playback
      No disk or network writes
    Tech stack
      Swift
      Xcode
      Core Audio
    Use cases
      Enable spatial audio for Spotify
      Use head tracked AirPods sound
      Try menu bar audio routing
    Audience
      General

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get Spatial Audio effects while listening to Spotify Desktop on supported AirPods.

USE CASE 2

Route system audio through Apple's spatial playback path without changing Spotify settings.

USE CASE 3

Build from source and inspect a small real world Core Audio tap and renderer project.

What is it built with?

SwiftXcodeCore AudiomacOS

How does it compare?

shevlfs/spatial-relayaakarsh-goyal/macjuicealtuzar/sonicflow
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an Apple silicon Mac, macOS 14.2+, Spatial Audio AirPods, and Spotify Desktop.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Spatial Relay is a small macOS app that lives in the menu bar at the top of the screen, with no icon in the Dock. Its job is to take the audio playing from the Spotify desktop app and route it through a different Apple audio system, one that supports Spatialize Stereo, a feature meant for AirPods models that support Spatial Audio. Normally Spotify sends its sound straight to whatever output device is selected. Spatial Relay instead taps into that audio stream, holds it briefly in memory, and hands it to Apple's own playback system so the Spatial Audio effects can be applied properly. The README stresses that it does not compress, resample, normalize, or change the volume of the audio in any way, it simply passes the same stereo signal through a different playback path, and Spotify's own sound quality settings still apply as normal. To use it, someone connects AirPods that support Spatial Audio, starts playing something in Spotify, opens Spatial Relay from its menu bar icon, and clicks a button to start the relay. macOS will then ask for permission to record system audio, which needs to be approved for the relay to work, and afterward a person can turn on Fixed or Head Tracked spatial audio from the normal macOS sound menu. The audio only stays in a temporary memory buffer, is never written to disk, sent anywhere over a network, or tracked in any way. The app only works on Apple silicon Macs running a recent version of macOS, with Spotify Desktop and Spatial Audio capable AirPods, and building it from source requires Xcode. Prebuilt versions are available on the project's release page but are not notarized by Apple, meaning a normal Gatekeeper trusted build requires compiling it yourself with a personal developer account. The project has one GitHub star, is written in Swift, includes automated tests that run through Apple's own build tooling, and is released under the MIT license. It is not affiliated with Spotify or Apple.

Copy-paste prompts

Prompt 1
Help me build Spatial Relay from source in Xcode for my Apple silicon Mac.
Prompt 2
Explain how Spatial Relay taps Spotify's audio and routes it to AVSampleBufferAudioRenderer.
Prompt 3
Walk me through granting Spatial Relay System Audio Recording access on macOS.
Prompt 4
What are the privacy guarantees Spatial Relay makes about my audio data?

Frequently asked questions

What is spatial-relay?

A macOS menu bar app that routes Spotify audio through Apple's Spatial Audio playback path for supported AirPods.

What language is spatial-relay written in?

Mainly Swift. The stack also includes Swift, Xcode, Core Audio.

What license does spatial-relay use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is spatial-relay to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is spatial-relay for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.