# kmikiy/SpotMenu

Spotify & Apple Music in your macOS menu bar

Repository: https://github.com/kmikiy/SpotMenu
Canonical: https://ross.abutalabs.com/products/spotmenu
Homepage: https://kmikiy.github.io/SpotMenu/
Language: Swift
License: MIT
License Family: permissive
Topics: spotify, swift, menu, menubar, bar, itunes
Last push: 2026-05-15T00:10:30+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 82, release rhythm 68, longevity 100
- inputs: {"age_days": 3652, "days_push": 111, "days_rel": 216, "gap_med": 3, "n_releases_24m": 12}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3131, forks 186 (observed 2026-08-28T04:07:45.516401+00:00)

## What it is
SpotMenu is a free, open-source macOS menu bar app that shows the currently playing track from Spotify or Apple Music with hover playback controls and album art. It is built with Swift and SwiftUI and offers global hotkeys, track liking via the Spotify Web API, and extensive customization options.

## Use cases
- show currently playing song in the macOS menu bar
- control Spotify playback without switching apps
- control Apple Music from the menu bar
- set global keyboard shortcuts for play, pause, and skipping tracks
- like or unlike Spotify tracks with a hotkey
- display album art in a compact playback panel
- save menu bar space with a compact two-line view

## When to choose
- you use Spotify or Apple Music on macOS and want quick playback control
- you want a native, lightweight, open-source menu bar music widget
- you prefer customizable appearance like blur, tint, and max width
- you want global hotkeys for media control

## When to avoid
- you use Linux or Windows - it is macOS 13+ only
- you need a full music player or playlist management app
- you want track liking for Apple Music - that feature is Spotify-only
- you need integration with other streaming services like YouTube Music

## Facets
- artifact type: application
- maturity: active
- function: gui, developer-tools
- domain: desktop-applications, media, developer-tools, apple-ecosystem
- platform: -
- tags: menu-bar, spotify, apple-music, swiftui, music-player-controls, global-hotkeys, open-source, macos, desktop

## Member repositories
- kmikiy/SpotMenu (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:45.516401+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:26:09.892458+00:00, confidence not recorded.
  - readme: https://github.com/kmikiy/SpotMenu (fetched 2026-08-28T04:07:45.516401+00:00, sha 135e2b55540d)
  - homepage: https://kmikiy.github.io/SpotMenu/ (fetched 2026-08-29T09:41:00.412881+00:00, sha 6f9b76ac13b4)
- Data as of 2026-08-30T08:39:29.467469+00:00.