# Musish/Musish

Apple Music...ish

Repository: https://github.com/Musish/Musish
Canonical: https://ross.abutalabs.com/products/musish
Homepage: https://musi.sh
Language: TypeScript
License: AGPL-3.0
License Family: copyleft
Topics: react, musickit, apple-music, apple, music, musickitjs
Last push: 2025-03-21T14:43:13+00:00

## Health v2 (maintenance only)
Score: 38/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 12, release rhythm 35, longevity 100
- inputs: {"age_days": 2832, "days_push": 530, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3214, forks 242 (observed 2026-08-28T04:07:49.436983+00:00)

## What it is
Musish is an unofficial open-source web app for Apple Music, built with React and Apple's MusicKit JS against the official Apple Music API. It includes optional serverless backend functions (AWS Lambda) for features like lyrics lookup via Genius.

## Use cases
- listen to Apple Music in a web browser without the official app
- self-host an alternative Apple Music web client
- browse and search the Apple Music catalog on the web
- build a custom music player using MusicKit JS
- run an open-source Apple Music frontend with my own developer token

## When to choose
- you want an open-source, self-hostable Apple Music web client
- you prefer a lightweight browser-based Apple Music experience
- you want a reference implementation of MusicKit JS in React

## When to avoid
- you need offline playback or full feature parity with the official Apple Music apps
- you don't have an Apple Music subscription or developer token
- you need a mobile or desktop native app

## Facets
- artifact type: application
- maturity: maintenance
- function: web-framework, http-server, search-engine
- domain: web-development, frontend, media, self-hosted
- platform: self-hosted, serverless
- tags: apple-music, musickit, music-streaming, react, webapp, unofficial-client, web-server, nodejs

## Member repositories
- Musish/Musish (main) score 38

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:49.436983+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-29T18:44:56.838414+00:00, confidence not recorded.
  - readme: https://github.com/Musish/Musish (fetched 2026-08-28T04:07:49.436983+00:00, sha 8ac667f381bb)
  - homepage: https://musi.sh (fetched 2026-08-29T09:38:22.424819+00:00, sha 225f2ebc451c)
- Data as of 2026-08-30T08:39:29.467469+00:00.