Vinyl 是一款 macOS 原生辅助应用,能将 Spotify 当前播放曲目的专辑封面以实时、可穿透的唱盘场景显示在桌面图标后方。

Stars

9

7 天增长

暂无数据

Fork 数

2

开放 Issue

0

开源协议

NOASSERTION

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它无需 Spotify 开发者凭证或账号连接,仅通过本地播放检测和公开嵌入元数据即可实现实时专辑封面展示,兼顾隐私与易用性。

适合谁使用

  • 使用 Spotify 的 macOS 用户
  • 桌面美化与视觉体验爱好者
  • 对 AppKit 桌面窗口及沙箱应用开发感兴趣的 macOS 开发者

典型使用场景

  • 在听歌时让桌面变成动态唱盘墙纸
  • 无需第三方壁纸或叠加层即可个性化桌面环境
  • 在音乐播放期间以生动交互的方式展示专辑封面

项目优势

  • 通过 Spotify 播放状态通知实现近乎即时的本地检测
  • 无需 Spotify API 凭证或用户账号连接
  • 完全沙箱化、支持硬化运行时,并附带声明无追踪的隐私清单
  • 支持多显示器并配有菜单栏控制,可保持桌面持续运行

使用前须知

  • 需通过 Xcode 并使用有效的 Apple Developer 团队构建(尽管 GitHub 发行版已签名并公证)
  • 仅适用于 macOS 上的 Spotify 桌面应用
  • 若需广泛分发,可能需确认符合 Spotify 的归属与封面使用要求

README 快速开始

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

  1. Open Vinyl.xcodeproj in Xcode.
  2. Select your Apple Developer team in Signing & Capabilities if Xcode asks.
  3. Build and run.
  4. 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.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

Blaizzy
精选
Blaizzy GitHub avatar

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 与机器学习AI 视觉与语音
985
uzairansaruzi
精选
uzairansaruzi GitHub avatar

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 与机器学习大语言模型
941
simonw
精选
simonw GitHub avatar

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.

开发者工具CLI 与终端
20