Repolode
Submit
kushalpandya

kushalpandya/Petrichor

An offline music player for macOS that plays local audio libraries across 40+ file formats, with smart playlists, lyrics and internet radio.

Open-source alternative to:Apple MusicMusicbeeSwinsian

View on GitHubWebsite
Stars
1,729
Forks
76
Open issues
27
Last commit
5 days ago

What is it?

Petrichor is a native macOS music player built for playing music files stored on your own disk. You add folders, it scans them and reads metadata into a local SQLite library, and it never modifies your audio files or folder structure. Library data stays on the machine.

The player supports more than 40 audio formats, including MP3, AAC, ALAC, FLAC, Ogg Vorbis, Opus, WAV, AIFF and DSD. It offers gapless playback, crossfade, ReplayGain normalization, an equalizer, Spatial Audio and AirPlay 2 output. Smart playlists can use conditional, negative and regular-expression rules, and the sidebar can be filled with pinned albums, artists or playlists.

The app is built with Swift and SwiftUI, with some AppKit code, and it includes menubar and Dock playback controls. Optional network features such as lyrics download, artist info, internet radio and Last.fm scrobbling are disabled by default.

Key features

  • 01Plays over 40 local audio formats, including lossless and DSD files.
  • 02Smart playlists with conditional, negative and regex rules.
  • 03Gapless playback, crossfade, ReplayGain, equalizer and AirPlay 2 output.
  • 04Synced lyrics display with the option to download missing lyrics.
  • 05Internet radio stations organized into collections.
  • 06Menubar and Dock playback controls, plus dark mode and a miniplayer.

Use cases

  • Playing a large personal collection of MP3, FLAC or other local files on a Mac.
  • Listening offline without a streaming subscription.
  • Organizing music with smart playlists and metadata-based browsing.
  • Listening to internet radio stations alongside a local library.

Quick start

  1. 1

    Install via Homebrew

    brew install --cask petrichor
  2. 2

    Or download the latest .dmg from the Releases page and drag the app into Applications

  3. 3

    In Applications, right-click Petrichor and choose Open

Things to know

  • macOS 14 or later only; no Windows or Linux version.
  • Relies heavily on good track metadata for its features to work well.

Topics

#audio-player#macos#swift#swiftui#offline#music-player#local-media#desktop-app#macos-app#macos-application

FAQ

What is Petrichor?
An offline music player for macOS that plays local audio libraries across 40+ file formats, with smart playlists, lyrics and internet radio. Petrichor is a native macOS music player built for playing music files stored on your own disk. You add folders, it scans them and reads metadata into a local SQLite library, and it never modifies your audio files or folder structure. Library data stays on the machine.
Is Petrichor free to use? What license does it have?
Petrichor is open source under the MIT license. Check the license terms before using it in commercial products.
Is Petrichor still maintained?
Actively maintained. The last commit to Petrichor was on Oct 16, 2026.
What can I use Petrichor for?
Playing a large personal collection of MP3, FLAC or other local files on a Mac. Listening offline without a streaming subscription. Organizing music with smart playlists and metadata-based browsing. Listening to internet radio stations alongside a local library.
How do I install Petrichor?
Install via Homebrew: brew install --cask petrichor Or download the latest .dmg from the Releases page and drag the app into Applications In Applications, right-click Petrichor and choose Open
Where can I get Petrichor?
The source code and installation instructions are on GitHub: https://github.com/kushalpandya/Petrichor

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects