Why it is worth attention

It achieves real-time album artwork display without requiring Spotify developer credentials or an account connection, using local playback detection and public embed metadata.

Who it is for

macOS users who are also Spotify subscribers
Desktop customization and aesthetic enthusiasts
macOS developers interested in AppKit desktop-level windows and sandboxed apps

Use cases

Enhancing the Spotify listening experience with a live turntable wallpaper
Customizing the desktop environment without third-party wallpapers or overlays
Showcasing album artwork in a dynamic, interactive manner during music playback

Strengths

Near-instant local detection via Spotify's playback-change notifications
No need for Spotify API credentials or user account connection
Fully sandboxed, hardened runtime, and a privacy manifest declaring no tracking
Supports multiple displays and includes a menu-bar control for persistent operation

Considerations

Requires building from Xcode with a valid Apple Developer team (though GitHub releases are signed and notarized)
Only works with the Spotify desktop app on macOS
Wider distribution may require confirming compliance with Spotify's attribution and artwork requirements

README quick start

Vinyl

Vinyl is a native macOS companion for the Spotify desktop app. It detects the item currently playing on your Mac and presents its artwork as a live, click-through turntable scene behind your desktop icons.

Run it

Open Vinyl.xcodeproj in Xcode.
Select your Apple Developer team in Signing & Capabilities if Xcode asks.
Build and run.
Open Spotify for Mac and play a track.

Vinyl does not need Spotify developer credentials or an account connection.

What is already wired up

Near-instant local detection from Spotify for Mac's playback-change notifications.
Album artwork lookup through Spotify's public embed metadata.
An AppKit desktop-level window on every connected display.
A textured turntable scene with a spinning record, album sleeve, tonearm, and live playback progress.
App Sandbox, hardened runtime, and outgoing-network entitlement.
A privacy manifest declaring no tracking or developer-side data collection.
A menu-bar control so the desktop can keep running after the main window is closed.

Distribution reality

GitHub release builds are signed with a Developer ID certificate and notarized by Apple for a normal, warning-free direct-download experience.

Before wider distribution, confirm that the desktop presentation satisfies Spotify's current attribution and artwork requirements.

Original implementation

The desktop-window idea was informed by ibuhs/Luviosa, a GPL-3.0 live-wallpaper project. Vinyl is independently implemented and does not include Luviosa source or media.

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy

Featured

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio

985

uzairansaruzi

Featured

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models

941

simonw

Featured

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal