Spotifly

February 22, 2026 · View on GitHub

A lightweight Spotify player for macOS.

Website · Download

Important

Spotify Client ID Required This app requires your own Spotify Client ID to function. Spotify has re-enabled developer access — you can create a Client ID for free in the Spotify Developer Dashboard. See Setting Up Your Client ID below for instructions and the February 2026 API changes for details on the current Web API.

Screenshots

Album View

Album View

Miniplayer

Miniplayer

Installation

Direct Download

  1. Download the latest release
  2. Extract the ZIP file
  3. Move Spotifly.app to your Applications folder
  4. Open Spotifly from Applications

Homebrew

brew install ralph/spotifly/spotifly

Requirements

  • macOS 26.2 or later
  • Spotify Premium account

Features

  • Lightweight and fast
  • Native macOS app built with SwiftUI
  • Spotify Web API integration
  • Recently played tracks, albums, artists, and playlists
  • Queue management with drag-and-drop reordering
  • Playback controls
  • Search functionality
  • Favorites management

Setting Up Your Client ID

Spotifly requires a Spotify Client ID. While it's recommended to create a new Spotify app just for Spotifly, you can also use an existing Spotify app—just add de.rvdh.spotifly://callback to its Redirect URIs (you can have multiple redirect URIs in one app).

  1. Go to the Spotify Developer Dashboard
  2. Click Create app
  3. Fill in the required fields:
    • App name: Anything you like (e.g., "Spotifly")
    • App description: Anything you like
    • Redirect URIs: Add exactly de.rvdh.spotifly://callback
    • APIs used: Select Web API and Web Playback SDK
  4. Accept the terms and click Save
  5. Open your newly created app and go to Settings
  6. Copy the Client ID (not the Client Secret)

All other fields (Website, Bundle IDs, Android packages) can be left empty.

Spotify Developer App Settings

Option B: Use an Existing Spotify App

If you already have a Spotify app configured:

  1. Go to your app in the Spotify Developer Dashboard
  2. Go to Settings
  3. Add de.rvdh.spotifly://callback to the Redirect URIs (you can have multiple)
  4. Save the settings
  5. Copy the Client ID

Configure Spotifly

  1. Open Spotifly
  2. Enter your Client ID on the login screen
  3. Click Connect with Spotify

Your Client ID will be saved securely in the macOS Keychain and used for all future sessions.

Keyboard Shortcuts

Playback

ShortcutAction
SpacePlay / Pause
⌘ →Next track
⌘ ←Previous track
⌘ LLike / Unlike current track
ShortcutAction
⌘ 1Go to Favorites
⌘ 2Go to Playlists
⌘ 3Go to Albums
⌘ 4Go to Artists
⌘ FFocus search field
⌘ RRefresh (on startpage)

Development

See DEVELOPMENT.md for build instructions and architecture documentation.

License

This project is licensed under the MIT License - see the LICENSE file for details.