Skip to content
forked from nbolar/PlayStatus

About

Native macOS menu bar player for Apple Music and Spotify — SoundPulse fork of PlayStatus with Tahoe Liquid Glass.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

SoundPulse SoundPulse-512

SoundPulse is a native SwiftUI macOS menu bar app for controlling Apple Music and Spotify. It is a fork of PlayStatus by Nikhil Bolar, rebranded and tuned for macOS Tahoe Liquid Glass.

License: MIT Platform SwiftUI

SoundPulse regular player

Regular player — artwork, transport, and menu bar popover chrome on Liquid Glass.

SoundPulse regular player with lyrics

Regular player with lyrics — synced lyrics pane under the now-playing surface.

SoundPulse mini player

Mini player — compact full-bleed artwork card for a tighter menu bar footprint.

SoundPulse mini player with lyrics

Mini player with lyrics — lyrics expand under the mini card without leaving the surface.

What you get

  • Menu bar now-playing with regular, mini, and detached player surfaces
  • Apple Music and Spotify control via Automation
  • Lyrics, credits, provider-aware search
  • Theme presets with Liquid Glass on macOS 26+ (material fallback earlier)
  • English / Russian UI language
  • Guided walkthrough / onboarding

Requirements

  • macOS 15.0 or later (Liquid Glass chrome on macOS 26+)
  • Xcode 26+ to build from source
  • Automation permission for Music and/or Spotify

Install

Every push to master builds an unsigned DMG and publishes a GitHub Release (v{version}.{build}).

  1. Open the Releases page and download the latest SoundPulse-*.dmg.
  2. Open the DMG, drag SoundPulse into Applications.
  3. First launch may be blocked by Gatekeeper — right-click the app → Open, or allow it in System Settings.
  4. Grant Automation access for Music / Spotify when asked.

Build

open SoundPulse.xcodeproj

Or from the command line:

xcodebuild -scheme SoundPulse -configuration Debug build

Unsigned DMG locally:

scripts/build-unsigned-dmg.sh

Set your Apple Development team in Xcode Signing & Capabilities before running a signed local build.

First launch

  1. Build and run SoundPulse, then move it to /Applications if desired.
  2. Choose Apple Music, Spotify, or both.
  3. Allow Automation when macOS asks.
  4. If no prompt appears, check System Settings → Privacy & Security → Automation.

Attribution

SoundPulse is based on PlayStatus (MIT License, Copyright © 2019–2026 Nikhil Bolar). Upstream Sparkle auto-update and Homebrew distribution are disabled in this fork; CI publishes unsigned DMGs instead.

License

MIT — see LICENSE.

About

Native macOS menu bar player for Apple Music and Spotify — SoundPulse fork of PlayStatus with Tahoe Liquid Glass.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages