# kushalpandya/Petrichor

An offline macOS music player

Repository: https://github.com/kushalpandya/Petrichor
Canonical: https://ross.abutalabs.com/products/petrichor
Homepage: https://petrichor.page
Language: Swift
License: MIT
License Family: permissive
Topics: audio-player, desktop-app, macos, macos-app, macos-application, macos-swift, mp3-player, music-player, ogg-vorbis
Last push: 2026-08-24T19:19:48+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 94, longevity 35
- inputs: {"age_days": 501, "days_push": 9, "days_rel": 42, "gap_med": 8, "n_releases_24m": 28}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1610, forks 69 (observed 2026-08-28T04:05:10.940208+00:00)

## What it is
Petrichor is a free, open-source, native macOS music player for offline local music libraries, supporting over 20 audio formats including MP3, FLAC, ALAC, Ogg Vorbis, and DSD. It offers library organization by metadata, smart playlists, synced lyrics, a 10-band equalizer, gapless playback, Last.fm scrobbling, and Siri/Shortcuts integration.

## Use cases
- play local mp3 and flac files on mac without streaming
- organize a large offline music library by artist album and genre
- create smart playlists with rules based on genre year and play count
- view synced lyrics while listening to tracks
- scrobble plays to last.fm from a local library
- play obscure audio formats like ape wavpack and dsd on mac
- control music playback with siri and shortcuts
- use an equalizer and gapless playback for local music

## When to choose
- you have a local music collection and want a native, offline macOS player
- you need broad audio format support including lossless and exotic formats
- you want streaming-app-like features (smart playlists, lyrics, go-to navigation) without a subscription
- you care about privacy and an app that never modifies your files

## When to avoid
- you want streaming services like Spotify or Apple Music built in
- you need a cross-platform player for Windows or Linux
- your tracks have poor or missing metadata, since the library relies heavily on tags
- you need extensive tag editing, as the app never writes to files

## Facets
- artifact type: application
- maturity: active
- function: audio-processing, gui
- domain: media, desktop-applications, apple-ecosystem
- platform: -
- tags: music-player, offline-music, audio-playback, playlists, lyrics, lastfm-scrobbling, equalizer, swift, native-app, macos, desktop

## Member repositories
- kushalpandya/Petrichor (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:10.940208+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-30T03:51:14.939686+00:00, confidence not recorded.
  - readme: https://github.com/kushalpandya/Petrichor (fetched 2026-08-28T04:05:10.940208+00:00, sha 6805fcf382d4)
  - homepage: https://petrichor.page (fetched 2026-08-29T11:23:19.317442+00:00, sha eb5edbf17c0a)
  - site_page: https://petrichor.page/features (fetched 2026-08-29T11:23:19.326534+00:00, sha 8c8ede0d2ca0)
  - site_page: https://petrichor.page/faq (fetched 2026-08-29T11:23:19.328523+00:00, sha 938bcae15628)
  - site_page: https://petrichor.page/changelog (fetched 2026-08-29T11:23:19.330479+00:00, sha 542226f5ea9a)
- Data as of 2026-08-30T08:39:29.467469+00:00.